По вопросам работы с Seller API обращайтесь в поддержку через личный кабинет.
Информационная платформа и сообщество разработчиков Ozon for dev


Ozon Seller API — программный интерфейс для работы с маркетплейсом Ozon. Он даёт возможность обмениваться информацией между системой продавца и Ozon.
Методы Seller API позволяют изменять данные магазина, например, остатки товаров или их стоимость, и получать данные, такие как информация о возвратах или список складов.
Работа с API состоит из отправки запроса и получения ответа. Для этого можно использовать вкладку Консоль, которая находится сверху описания методов, Postman или настроить интеграцию с системами учёта, например, 1С, ERP или МойСклад.
При интеграции системы учёта продавца с Seller API обновлять и получать данные можно в автоматическом режиме. Это поможет поддерживать актуальной информацию о ценах и остатках товаров, обрабатывать больше заказов за меньшее время и исключить ошибки из-за обновления данных вручную.
Например, вам нужно обновить информацию об остатках или ценах 100 товаров. Чтобы сделать это через личный кабинет, необходимо вручную изменить данные на карточке каждого товара.
Метод /v2/products/stocks позволяет одним запросом обновить информацию об остатках сразу 100 товаров, а метод /v1/product/import/prices — их стоимость.
Перед началом работы с Ozon Seller API:
Для работы с Seller API необходим API-ключ. Подробнее в разделе Авторизация.
Seller API работает по UTC. Учитывайте это, когда отправляете запросы и получаете ответы с датами и временем.
Процесс работы с Seller API можно разделить на блоки:
Чтобы получить API-ключ:
Вы можете создать несколько API-ключей. Например, если у вас несколько пользователей с разными уровнями доступа.
Если вы хотите изменить разрешённые сети для ключа, в списке API-ключей выберите нужный и нажмите
.
Внесите изменения и нажмите Обновить.
Чтобы получить OAuth-токен для доступа к Seller API, создайте частное или публичное приложение и выдайте ему доступ к вашему личному кабинету. После этого вы получите OAuth-токен, который позволит работать с методами Seller API.
Используйте OAuth-токен с методами Seller API согласно уровням доступа, которые вы назначили приложению.
Пример запроса:
POST https://api-seller.ozon.ru/{эндпоинт метода Seller API}
Authorization: Bearer ACCESS_TOKEN
Рабочая среда — это ваш магазин. Все отправленные запросы, кроме информационных, могут изменять данные в личном кабинете и на сайте Ozon.
Рабочая среда: api-seller.ozon.ru
Созданные товары можно посмотреть по ссылке вида: https://www.ozon.ru/context/detail/id/SKU, где вместо «SKU» нужно указать значение для созданного товара.
GET / HTTP/1.1
Host: api-seller.ozon.ru
Client-Id: <Client-Id>
Api-Key: <Api-Key>
Content-Type: application/json
Для проверки корректности формата запроса используйте вкладку Консоль над описанием метода или Postman.
/v1/description-category/tree — получите список категорий и типов в виде дерева и используйте значение последнего уровня выбранной категории.
/v1/description-category/attribute — получите характеристики для выбранных категории и типа.
/v1/description-category/attribute/values — получите список значений для выбранной характеристики.
После сравнения своих атрибутов и характеристик с атрибутной моделью Ozon можете приступить к загрузке товаров:
/v3/product/import — загрузите товары и услуги. Этот метод также позволяет обновить уже загруженные товары. В запросе устанавливается первичная цена и загружаются изображения товара.
В одном запросе можно передать до 100 товаров. Изображения загружаются прямой ссылкой на облачное хранилище, где они хранятся.
В результате работы метода вы получите task_id — номер задания на загрузку товаров.
/v1/product/import/info — проверьте task_id, который вы получили при
загрузке товаров. Метод вернёт информацию, успешно ли загрузились товары или при импорте была ошибка.
Если ответ содержит статус, что товар на модерации, подождите её результатов и проверьте статус товара повторно. Обычно модерация занимает меньше одного дня.
/v3/product/list — получите список созданных товаров после загрузки товаров.
Метод позволяет использовать фильтры, чтобы разбить товары на группы по статусу видимости или отслеживать изменение их статуса с помощью идентификатора товара.
Метод возвращает пару значений offer_id и product_id — они нужны практически во всех запросах для идентификации
товара, с которым будет производиться действие. Если вы загружали товары через шаблон, используйте этот метод для
получения offer_id и product_id, чтобы в дальнейшем работать по API с товарами.
Чтобы добавить изображения товара или заменить существующие, используйте:
Чтобы обновить информацию о товаре и его характеристики, используйте /v3/product/import.
Если нужно обновить только характеристики товара, используйте /v1/product/attributes/update.
/v3/product/info/list — получите информацию о товаре, например штрихкод, цену главного предложения, идентификатор категории, комиссию или ошибки модерации. С помощью фильтров /v3/product/list получите список пакетно по всем товарам сразу или по категориям.
/v4/product/info/attributes — получите описание характеристик товара. Метод позволяет добавить дополнительную информацию к товару, чтобы карточка товара была более полной.
/v1/product/info/description — получите описание товара, чтобы использовать его для создания схожего товара.
/v1/product/info/discounted — получите информацию об уценке и основном товаре по SKU уценённого товара.
/v2/products/delete — удалите товар, если он загрузился с ошибкой и попал в архив без SKU. Товары, которые успешно прошли модерацию и получили SKU, удалить из архива нельзя.
/v1/product/archive — перенесите товар в архив. Перед архивированием товара обнулите его остатки.
/v1/product/unarchive — верните товар из архива.
Товар попадёт в продажу, только когда вы установите его остаток.
type — значение value из ответа /v1/product/certificate/types;status — значение code из ответа v1/product/certificate/status/list.Чтобы привязать сертификат к товару:
Чтобы посмотреть список товаров, привязанных к сертификату, воспользуйтесь методом v1/product/certificate/products/list.
Если нужно получить список товаров с определённым статусом, в параметре status передайте значение code из ответа v1/product/certificate/product_status/list.
Чтобы отвязать товар от сертификата, используйте /v1/product/certificate/products/unbind.
Чтобы получить атрибуты для управления сертификатом:
Для создания сертификата используйте /v1/product/certificate/create, передав в запросе:
type_code — значение value из ответа /v1/product/certificate/types;accordance_type_code — значение code из ответа /v2/product/certificate/accordance-types/list.Чтобы удалить сертификат, используйте /v1/product/certificate/delete.
После загрузки товаров для схем FBS и rFBS можно перейти к обновлению остатков. Для схемы FBO остатки обновляются автоматически по факту продажи.
Для обновления остатков используйте метод /v2/products/stocks. В этом методе дополнительно указывается идентификатор склада, на котором необходимо изменить остатки.
Для получения информации о количестве остатков для FBO используйте /v4/product/info/stocks.
Для получения информации о количестве остатков для FBS и rFBS используйте v1/product/info/stocks-by-warehouse/fbs.
Чтобы обновить цены по товарам и не менять карточку товара, используйте /v1/product/import/prices.
Метод позволяет обновить цену:
Для получения информации о ценах, комиссиях и скидках на товары используйте /v5/product/info/prices.
Если товары заказывают юридические лица, оплата может поступать не сразу — система зарезервирует товары.
Чтобы проверить остатки, используйте методы /v3/posting/fbs/get, /v3/posting/fbs/list или /v3/posting/fbs/unfulfilled/list.
Если в ответе is_legal = true, значит среди остатков есть зарезервированные товары.
Вы можете обновить остатки так, чтобы новое количество товаров было больше свободного остатка и зарезервированного товара в сумме.
Система спишет старый остаток и рассчитает новый.
Чтобы проверить резервирование товара, используйте методы /v1/product/info/stocks-by-warehouse/fbs или /v4/product/info/stocks.
Для продвижения товаров участвуйте в акциях, которые Ozon проводит для покупателей.
Получите список доступных акций: /v1/actions.
Получите список товаров, которые могут участвовать в акции: /v1/actions/candidates.
Добавьте товары в акцию: /v1/actions/products/activate.
Получите список товаров, которые участвуют в акции: /v1/actions/products.
Удалите товары из акции: /v1/actions/products/deactivate.
Покупатели могут попросить у вас скидку на товар.
Чтобы получить список товаров, которые покупатели хотят купить со скидкой, воспользуйтесь методом
/v1/actions/discounts-task/list.
Заявки в статусах NEW (новые) или SEEN (просмотренные) вы можете:
Стратегии ценообразования — инструмент для автоматического изменения стоимости товаров в соответствии с ценами на аналогичные товары в других интернет-магазинах и маркетплейсах.
Подробнее о стратегиях в Базе знаний для продавцов из России
Подробнее о стратегиях в Справке для продавцов Ozon Global
Чтобы настроить стратегии ценообразования:
Получите список конкурентов: /v1/pricing-strategy/competitors/list.
Получите список стратегий ценообразования: /v1/pricing-strategy/list.
Создайте свою стратегию: /v1/pricing-strategy/create и установите коэффициенты, чтобы изменять стоимость товара по сравнению с другими площадками в большую и меньшую сторону. Чтобы получить информацию о стратегии, используйте метод /v1/pricing-strategy/info.
Добавьте товары в стратегию: /v1/pricing-strategy/products/add.
Вы можете добавить товары:
Чтобы получить список товаров, которые привязаны к стратегии, используйте метод /v1/pricing-strategy/products/list, а для удаления товаров из стратегии — /v1/pricing-strategy/products/delete.
Включите или отключите стратегию: /v1/pricing-strategy/status.
Чтобы изменить список выбранных конкурентов и название стратегии, используйте метод /v1/pricing-strategy/update.
Для удаления стратегии используйте метод /v1/pricing-strategy/delete.
/v1/delivery-method/list — получите список методов склада.
/v1/warehouse/list — получите список складов.
warehouse_id.operation_id.operation_id.operation_id.operation_id.Обработайте заказы в зависимости от схемы работы:
Если вы продаёте товары из-за рубежа, обрабатывайте заказы по одной из схем:
Подробнее о заказах с весовыми товарами при работе по схеме rFBS
Перед созданием заявки на поставку проверьте загруженность складов Ozon: /v1/supplier/available_warehouses.
Для получения списка отправлений, финансовой и аналитической информации используйте /v2/posting/fbo/list. Также метод возвращает информацию о проданных кодах активации с привязкой к номеру отправления.
Чтобы получить информацию по отправлению, используйте /v2/posting/fbo/get.
Для поставки на фулфилмент Ozon нужна заявка. В ней указано, какие товары и в каком количестве вы привезёте.
Для проезда на фулфилмент выберите интервал поставки и оформите пропуск для водителя и автомобиля. Для этого:
Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
Получите идентификаторы экземпляров exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Подтвердите отгрузку и запустите формирование транспортной накладной методом /v2/posting/fbs/act/create или создайте отгрузку с помощью метода /v1/carriage/create и подтвердите её методом /v1/carriage/approve. В ответе методов /v2/posting/fbs/act/create и /v1/carriage/create вы получите идентификатор созданной перевозки.
Запросите информацию о созданной поставке с помощью метода /v1/carriage/get.
Массив available_actions содержит информацию о доступных действиях с поставкой и необходимости создать пропуск для проезда на склад Ozon.
Чтобы создать пропуск, используйте метод /v1/carriage/pass/create.
Чтобы после поставки товаров вы могли забрать возвраты на этой же машине, передайте значение with_returns = true.
Для каждой поставки нужен новый пропуск.
Для редактирования или удаления пропуска используйте методы /v1/carriage/pass/update и /v1/carriage/pass/delete.
Список всех пропусков можно получить с помощью метода /v1/pass/list.
Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list или /v1/carriage/delivery/list.
Проверьте, что отгрузка создана: /v2/posting/fbs/act/check-status.
Получите штрихкод для отгрузки: /v2/posting/fbs/act/get-barcode.
Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status.
Когда статус документа перейдёт в FORMED, получите файлы:
После этого можете отвезти отправления и документы в пункт приёма.
Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть
спор: /v2/posting/fbs/arbitration. Открытый спор переведёт
отправление в статус arbitration.
Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.
Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.
Для передачи спорных заказов к отгрузке
используйте /v2/posting/fbs/awaiting-delivery. Статус
отправления изменится на awaiting_deliver.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Получите список необработанных отправлений: /v3/posting/fbs/list или /v3/posting/fbs/unfulfilled/list. В ответе проверьте:
is_blr_traceable — признак прослеживаемости товара;require_blr_traceable_attrs = true — если нужно заполнить атрибуты прослеживаемости;split_before_ship = true — если нужно разделить заказ.Отфильтруйте прослеживаемые отправления, используя фильтр is_blr_traceable = true: /v3/posting/fbs/list.
Если заказ с прослеживаемостью, разделите его: /v1/posting/fbs/traceable/split.
Проверьте, нужно ли заполнять атрибуты прослеживаемости: /v1/posting/fbs/product/traceable/attribute.
Если атрибуты нужны, укажите их для карточки товара в личном кабинете или через API:
Передайте экземпляры товара и соберите отправление: /v4/posting/fbs/ship.
Получите список нулевых отгрузок: /v1/carriage/delivery/list. Прослеживаемые отгрузки будут иметь признак all_blr_traceable.
Создайте перевозку с прослеживаемыми товарами: /v1/carriage/create. В запросе укажите is_blr_traceable = true.
Если точка отгрузки не поддерживает электронную ТТН, вернётся ошибка BLR_TRACEABLE_PICKUP_NOT_ALLOWED.
Получите информацию о созданной перевозке: /v1/carriage/get. В ответе получите признак all_blr_traceable.
Создайте и загрузите на проверку электронную ТТН через систему электронного документооборота — ЭДО.
Получите статус электронной ТТН: /v1/carriage/ettn/status.
Подтвердите перевозку: /v1/carriage/approve. Если электронная ТТН не прошла проверку, вернётся ошибка INCORRECT_E_WAYBILL_STATUS.
Обновите товарный состав перевозки, если нужно: /v1/carriage/set-postings. Если электронная ТТН не прошла проверку, вернётся ошибка INCORRECT_E_WAYBILL_STATUS.
Перед началом работы с отправлениями получите список необработанных отправлений: /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
Перед сборкой убедитесь, что отправление соответствует установленным в пункте приёма ограничениям. Получите ограничения пункта приёма по номеру отправления: /v1/posting/fbs/restrictions.
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Подтвердите отгрузку и запустите формирование транспортной накладной методом /v2/posting/fbs/act/create или создайте перевозку с помощью метода /v1/carriage/create и подтвердите её методом /v1/carriage/approve. В ответе методов /v2/posting/fbs/act/create и /v1/carriage/create вы получите идентификатор созданной перевозки.
Получите список перевозок, по которым нужно распечатать штрихкод для отгрузки и транспортную накладную: /v1/posting/carriage-available/list или /v1/carriage/delivery/list.
Проверьте статус формирования накладной: /v2/posting/fbs/digital/act/check-status.
Когда статус документа перейдёт в FORMED, получите файлы:
Для каждого отправления распечатайте наклейку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
После того как вы упаковали все отправления по требованиям из раздела Доверительная приёмка грузового места в Базе знаний продавца, получите этикетки на каждое грузовое место: /v2/posting/fbs/act/get-container-labels.
После этого можете передать грузовое место в пункт приёма или курьеру Ozon.
Если отправление передано в доставку, но не просканировано в сортировочном центре, вы можете открыть
спор: /v2/posting/fbs/arbitration. Открытый спор переведёт
отправление в статус arbitration.
Если спор по отправлению откроет покупатель, статус отправления изменится на client_arbitration.
Чтобы отследить изменение статуса, когда отправление найдено, используйте /v3/posting/fbs/list с нужными фильтрами.
Для передачи спорных заказов к отгрузке
используйте /v2/posting/fbs/awaiting-delivery. Статус
отправления изменится на awaiting_deliver.
v1/delivery/check — проверьте, может ли покупатель получить заказ через Ozon. Способы доставки для Ozon Логистики:
Если способ доставки — самовывоз, передайте идентификатор точки самовывоза в параметр pickup.
При курьерской доставке передайте адрес получения и координаты в параметр courier.
v1/delivery/map — укажите точки на карте, из которых покупатель может забрать заказ.
v1/delivery/point/list — получите список точек самовывоза.
/v1/delivery/point/info — получите информацию о точке самовывоза.
/v2/delivery/checkout — проверьте доступность товара и сроки доставки.
Предоставьте выбор способа доставки и точки доставки на этапе оформления заказа или в корзине. Если это невозможно, кешируйте данные на своей стороне, чтобы снизить нагрузку и оптимизировать количество запросов к API.
Создавайте заказ в системе Ozon только после того, как покупатель оплатил его.
Для схемы FBO:
Для схемы FBS:
Если покупатель при получении отправления отказался от одного из товаров, отправление останется в статусе «Доставлено». Используйте v1/returns/list, чтобы получить информацию по возврату с невыкупленным товаром. Тип такого возврата — type: PartialReturn.
Можно отменить заказы, которые создали с помощью методов Ozon Логистики, если:
Для отмены заказа или его части:
Для отмены FBS-отправлений:
v1/returns/list — отследите статус возврата товара. Используйте, если покупатель отменил заказ во время перевозки или не забрал его при получении. Возвраты от покупателей продавец забирает своими силами. Если покупатель забрал товар и после этого решил его вернуть, он должен связаться с продавцом.
Если покупатель отказался от одного из товаров при получении отправления, оно останется в статусе «Доставлено». Система создаст новое отправление в статусе «Отменено» с типом отмены PartialRefund. Получите информацию о нём методом v1/returns/list.
Если на складах Ozon недостаточно товаров, создать заказ через методы Ozon Логистики не получится.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода
/v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в
параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list,
/v3/posting/fbs/list или /v3/posting/fbs/get.
После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Если вы продаёте весовые товары, и в параметре result.products.is_weight_needed для товара указано true, передайте информацию о весе товара методом /v6/fbs/posting/product/exemplar/set.
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Когда сборка заказа завершена, свяжитесь с покупателем для согласования даты доставки. Если покупателю не подходит дата, вы можете перенести её: /v1/posting/fbs/timeslot/set. Посмотрите доступные даты для переноса доставки и количество доступных переносов: /v1/posting/fbs/timeslot/change-restrictions.
Передайте отправление курьеру:
Когда курьер забрал отправление, измените статус отправления на «Доставляется»: /v2/fbs/posting/delivering.
Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.
Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.
Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора стран: /v2/posting/fbs/product/country/list.
Затем передайте информацию о стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами.
Можно также получить данные аналитики, если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Передайте отправление курьеру.
Дальше подстатусы будут изменяться автоматически:
on_way_to_city — курьер забрал заказ. on_way_to_pickup_point — курьер везёт заказ в пункт выдачи.in_pickup_point — отправление приняли в пункте выдачи.delivered — покупатель забрал заказ из пункта выдачи.Чтобы проверить статус отправления, используйте метод /v3/posting/fbs/list.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана. Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
Если товар в отправлении упакован в несколько коробок, передайте их количество: /v3/posting/multiboxqty/set. Если не сделать этого до сборки, вам придётся объединить все коробки в одну.
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_registration.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Когда перевозчик обработает отправление, его статус изменится с awaiting_registration на awaiting_delivery. После
этого отправлению будет присвоен трек-номер.
Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.
Если вы продаёте из Турции и вам нужны декларации Elektronik Ticaret Gümrük Beyannamesi (ETGB) для возврата налоговой пошлины, получите декларации: /v1/posting/global/etgb.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Если в параметре available_actions указано set_cutoff, уточните дату отгрузки отправления с помощью метода
/v1/posting/cutoff/set. Сделайте это не позднее даты, которая указана в
параметре shipment_date в методах: /v3/posting/fbs/unfulfilled/list,
/v3/posting/fbs/list или /v3/posting/fbs/get.
После даты shipment_date уточнить дату отгрузки и собрать отправление не получится.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените
статус отправления на sent_by_seller — «Отправлено
продавцом»: /v2/fbs/posting/sent-by-seller.
После передачи отправления в службу доставки измените статус отправления на delivering —
«Доставляется»: /v2/fbs/posting/delivering.
Одновременно с этим, если у отправления есть трек-номер, передайте его: /v2/fbs/posting/tracking-number/set.
Когда курьер едет к покупателю, поменяйте статус отправления на «Последняя миля»: /v2/fbs/posting/last-mile.
Когда курьер передал отправление покупателю, поменяйте статус на «Доставлено»: /v2/fbs/posting/delivered.
Перед началом работы с отправлениями получите список необработанных заказов (отправлений): /v3/posting/fbs/unfulfilled/list.
Если покупатель юридическое лицо, то в блоке requirements будет информация о необходимости передать
страну-производителя для всех товаров в заказе, у которых она не указана.
Получите список доступных для выбора
стран: /v2/posting/fbs/product/country/list. Затем передайте
информацию о
стране-производителе: /v2/posting/fbs/product/country/set.
Также можно получать список заказов (отправлений): /v3/posting/fbs/list.
Он позволяет получить все заказы, используя фильтры с различными статусами. Можно также получить данные аналитики,
если поле with отправить со значением analytics_data.
Отправления могут прийти в статусах awaiting_packaging, awaiting_approve или awaiting_verification.
Получите дополнительную информацию о заказах: /v3/posting/fbs/get.
В блоке requirements указывается:
Дополнительную информацию вы также можете получить по штрихкоду: /v2/posting/fbs/get-by-barcode.
Проверьте, что коды маркировки соответствуют требованиям системы «Честный ЗНАК» по составу и количеству символов: /v4/fbs/posting/product/exemplar/validate.
С помощью метода /v5/fbs/posting/product/exemplar/set добавьте для каждого экземпляра маркировку, которую будете передавать в систему «Честный ЗНАК». При необходимости передайте номера таможенных деклараций и регистрационные номера партии товара или укажите, что их нет.
Подробнее о маркировке «Честный ЗНАК» в Базе знаний
Получите статусы передачи маркировок:
До окончания времени на сборку подтвердите, что вы собрали заказ: /v4/posting/fbs/ship. Вы не сможете собрать заказ, если:
awaiting_packaging;При необходимости используйте этот метод, чтобы разделить заказ на несколько отправлений. Например, если в заказе несколько товаров и их необходимо упаковать в разные коробки, так как вместе они не отвечают требованиям к упаковке.
После использования метода статус отправления изменится на awaiting_deliver.
Вы можете использовать метод для частичной сборки: /v4/posting/fbs/ship/package.
Для каждого отправления распечатайте этикетку для идентификации в системе Ozon: /v2/posting/fbs/package-label.
Если в настройках метода доставки вы задали временной промежуток для передачи отправления в службу доставки, измените
статус отправления на sent_by_seller — «Отправлено
продавцом»: /v2/fbs/posting/sent-by-seller.
Передайте отправление в службу доставки. Все статусы от «Доставляется» до «Доставлено» будет передавать служба доставки.
Используйте /v2/posting/fbs/cancel-reason/list на любом этапе работы с отправлением, чтобы получить список причин отмены отправления.
Передайте этот список и номер отправления: /v2/posting/fbs/cancel.
Чтобы отменить часть товаров в отправлении, используйте /v2/posting/fbs/product/cancel.
Если отправление отменит покупатель, статус изменится на cancelled.
Перед тем, как перевести заказ с весовыми товарами в статус «Ожидает отгрузки» — awaiting_delivery, передайте
уточнённые данные о весе товаров. Для этого после взвешивания перед сборкой передайте информацию о весе
каждого экземпляра весовых товаров через метод /v6/fbs/posting/product/exemplar/set.
Метод /v6/fbs/posting/product/exemplar/set вернёт ошибки:
WEIGHT_IS_OUT_OF_RANGE — если вы передали вес, который выходит за границы допустимого;WEIGHT_IS_REQUIRED — если вы не передали вес для весовых товаров.Если в методе /v3/posting/fbs/get
в параметре result.products.is_weight_needed для товара указано значение true, взвесьте товар.
После передачи корректного веса для всех экземпляров всех весовых товаров вы сможете перевести отправление в статус
«Ожидает отгрузки» — awaiting_delivery.
Если в заказе с весовыми товарами есть невзвешенные товары, при вызове метода /v4/posting/fbs/ship
вернётся ошибка WEIGHT_IS_REQUIRED.
/v1/fbp/warehouse/list — получите список партнёрских складов.
/v1/fbp/draft/direct/product/validate — передайте список товаров, чтобы проверить, может ли склад партнёра их принять.
/v1/fbp/draft/direct/timeslot/get — получите список таймслотов для прямой поставки.
Выберите способ доставки:
• /v1/fbp/draft/direct/seller-dlv/create — создайте черновик заявки на поставку.
• /v1/fbp/draft/direct/timeslot/edit — измените таймслот для поставки в черновике заявки.
• /v1/fbp/draft/direct/seller-dlv/edit — обновите информацию о доставке силами продавца в черновике заявки.
• /v1/fbp/draft/direct/tpl-dlv/create — создайте черновик заявки на поставку.
• /v1/fbp/draft/direct/timeslot/edit — измените таймслот для поставки в черновике заявки.
• /v1/fbp/draft/direct/tpl-dlv/edit — обновите информацию о доставке силами сторонней траспортной компании в черновике заявки.
/v1/fbp/draft/list — получите список черновиков.
/v1/fbp/draft/get — получите информацию о черновике на поставку. Если в черновике есть ошибка, используйте /v1/fbp/draft/direct/delete, чтобы удалить его.
/v1/fbp/draft/direct/registrate — переведите черновик заявки на поставку в активную заявку.
/v1/fbp/order/direct/timeslot/list — получите актуальные таймслоты склада для поставки.
/v1/fbp/order/direct/timeslot/edit — измените актуальный таймслот поставки.
/v1/fbp/order/direct/seller-dlv/edit или /v1/fbp/order/direct/tpl-dlv/edit — передайте актуальную информацию о доставке, если доставляете самостоятельно или через перевозчика.
/v1/fbp/order/list — получите список поставок.
/v1/fbp/order/get — получите информацию о конкретной поставке. Если в заявке на поставку есть ошибка, используйте /v1/fbp/order/direct/cancel, чтобы отменить поставку.
/v1/fbp/label/create — создайте задание на генерацию этикеток.
/v1/fbp/label/get — получите этикетки и статус задания на их генерацию.
/v1/fbp/act-to/create — создайте задание на генерацию транспортной накладной.
/v1/fbp/act-to/get — получите транспортную накладную и статус задания на её генерацию.
/v1/fbp/act-from/create — создайте задание на генерацию акта приёмки.
/v1/fbp/act-from/get — получите акт приёмки и статус задания на его генерацию.
/v1/fbp/archive/list — получите список завершённых поставок.
/v1/fbp/archive/get — получите информацию о конкретной завершённой поставке.
/v1/returns/list — получите информацию о возвращённых товарах.
Убедитесь, что вы можете получать возвратные отгрузки по штрихкоду: /v1/return/giveout/is-enabled. Если у вас есть доступ, в параметре enabled будет указано значение true.
Чтобы получить возвратную отгрузку, запросите штрихкод:
Получите информацию и список возвратных отгрузок:
Вы можете забрать возвраты отдельно от поставки товаров. Если для проезда на склад Ozon нужен пропуск, создайте его с помощью метода /v1/return/pass/create. Для каждого проезда за возвратами нужен новый пропуск.
Для редактирования и удаления пропуска используйте методы /v1/return/pass/update и /v1/return/pass/delete.
Список всех пропусков можно получить с помощью метода /v1/pass/list.
Получите заявки и информацию о них:
Вы можете одобрить, компенсировать, подтвердить возврат денег, запросить товар для проверки и отклонить заявку методом /v1/returns/rfbs/action/set.
Для передачи корректного action получите список доступных для конкретного возврата, в методе /v2/returns/rfbs/get.
Для получения списка чатов используйте /v3/chat/list. В ответе будут идентификаторы текущих чатов и последних сообщений.
Для отправки сообщений по идентификатору чата используйте методы:
/v1/chat/send/message — для отправки текстового сообщения.
/v1/chat/send/file — для отправки файла или изображения.
Для получения истории чата по идентификатору чата или сообщения используйте метод /v3/chat/history. Направление сортировки по умолчанию — от новых сообщений к старым.
Если указать идентификатор сообщения, то история начнётся с этого сообщения.
Чтобы создать новый чат с покупателем по номеру отправления, воспользуйтесь /v1/chat/start.
Чтобы отметить сообщение и все сообщения до него прочитанными, используйте /v2/chat/read.
При запросе любого из отчётов сначала возвращается код на создание документа. Отправьте его в запросе метода /v1/report/info — в ответе вернётся файл отчёта и дополнительная информация.
Чтобы получить список сформированных ранее отчётов, используйте /v1/report/list.
Методы для получения отчётов:
/v1/report/products/create — отчёт с данными о товарах, например Ozon ID, описанием товара, цены, комиссии или габаритов упаковки.
/v3/finance/transaction/list — отчёт по транзакциям, доступный в личном кабинете продавца.
/v4/product/info/price — отчёт по ценам.
/v1/report/warehouse/stock — отчёт по остаткам на складе.
/v2/report/returns/create — отчёт о возвращённых товарах для FBS и rFBS. Отчёт содержит товары, принятые от покупателя, готовые к получению или переданные продавцу.
/v1/report/postings/create — отчёт об отправлениях.
/v1/finance/cash-flow-statement/list — финансовый отчёт.
/v1/report/discounted/create — отчёт об уценённых товарах.
/v1/analytics/data — получите данные аналитики.
Если укажете период и метрики, которые нужно рассчитать, в ответе будет аналитиĸа, сгруппированная по параметру
dimensions.
/v1/analytics/stocks — получите аналитику по остаткам товаров на складах.
Чтобы получить отчёт по оборачиваемости FBO, запросите его в личном кабинете.
/v3/finance/transaction/list — получите подробную информацию по транзакциям для отправления.
/v3/finance/transaction/totals — получите детальную информацию по итоговым суммам транзакций за указанный период.
/v1/rating/summary — получите текущие значения рейтингов продавца.
/v1/rating/history — получите информацию о рейтингах продавца за период и количество штрафных баллов, начисленных в Premium-программе.
Метод для получения информации и ролях и методах, привязанных к API-ключу.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о доступных ролях и методах. | |||||
Array ()
| |||||
{ }{- "roles": [
- {
- "name": "Admin",
- "methods": [
- "/v1/actions"
]
}, - {
- "name": "Posting FBS",
- "methods": [
- "/v1/posting"
]
}
]
}Возвращает категории и типы для товаров в виде дерева.
Создание товаров доступно только в категориях последнего уровня, сравните именно их с категориями на своей площадке. Категории не создаются по запросу пользователя.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| language | string Default: "DEFAULT" Enum: "DEFAULT" "RU" "EN" "TR" "ZH_HANS" Язык в ответе:
По умолчанию используется русский язык. |
Array of objects Список категорий. | |||||||||||||
Array ()
| |||||||||||||
{- "language": "DEFAULT"
}{- "result": [
- {
- "description_category_id": 17027492,
- "category_name": "Канцелярские товары",
- "disabled": false,
- "children": [
- {
- "description_category_id": 17029016,
- "category_name": "Печати и штампы",
- "disabled": false,
- "children": [
- {
- "type_name": "Пистолет-маркиратор",
- "type_id": 970778135,
- "disabled": false,
- "children": [ ]
}
]
}
]
}
]
}Получение характеристик для указанных категории и типа товара.
Если у dictionary_id значение 0, у атрибута нет вложенных справочников.
Если значение другое, то справочники есть. Запросите их методом /v1/description-category/attribute/values.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| description_category_id required | integer <int64> Идентификатор категории. Можно получить с помощью метода /v1/description-category/tree. |
| language | string Default: "DEFAULT" Enum: "DEFAULT" "RU" "EN" "TR" "ZH_HANS" Язык в ответе:
По умолчанию используется русский язык. |
| type_id required | integer <int64> Идентификатор типа товара. Можно получить с помощью метода /v1/description-category/tree. |
Array of objects Результат запроса. | |||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||
{- "description_category_id": 200000933,
- "language": "DEFAULT",
- "type_id": 93080
}{- "result": [
- {
- "id": 31,
- "attribute_complex_id": 0,
- "name": "Бренд в одежде и обуви",
- "description": "Укажите наименование бренда, под которым произведён товар. Если товар не имеет бренда, используйте значение \"Нет бренда\"",
- "type": "string",
- "is_collection": false,
- "is_required": true,
- "is_aspect": false,
- "max_value_count": 0,
- "group_name": "",
- "group_id": 0,
- "dictionary_id": 28732849,
- "category_dependent": true,
- "complex_is_collection": true
}
]
}Возвращает справочник значений характеристики.
Узнать, есть ли вложенный справочник, можно через метод /v1/description-category/attribute.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| attribute_id required | integer <int64> Идентификатор характеристики. Можно получить с помощью метода /v1/description-category/attribute. |
| description_category_id required | integer <int64> Идентификатор категории. Можно получить с помощью метода /v1/description-category/tree. |
| language | string Default: "DEFAULT" Enum: "DEFAULT" "RU" "EN" "TR" "ZH_HANS" Язык в ответе:
По умолчанию используется русский язык. |
| last_value_id | integer <int64> Идентификатор справочника, с которого нужно начать ответ. Если |
| limit required | integer <int64> Количество значений в ответе:
|
| type_id required | integer <int64> Идентификатор типа товара. Можно получить с помощью метода /v1/description-category/tree. |
| has_next | boolean Признак, что в ответе вернулась только часть значений характеристики:
| ||||||||
Array of objects Значения характеристики. | |||||||||
Array ()
| |||||||||
{- "attribute_id": 85,
- "description_category_id": 17054869,
- "language": "DEFAULT",
- "last_value_id": 0,
- "limit": 100,
- "type_id": 97311
}{- "result": [
- {
- "id": 5055881,
- "value": "Sunshine",
- "info": "",
}, - {
- "id": 5056737,
- "value": "Essence",
- "info": "Красота и здоровье",
}
], - "has_next": true
}Возвращает справочные значения характеристики по заданному значению value в запросе.
Узнать, есть ли вложенный справочник, можно через метод /v1/description-category/attribute.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| attribute_id required | integer <int64> Идентификатор характеристики. Можно получить с помощью метода /v1/description-category/attribute. |
| description_category_id required | integer <int64> Идентификатор категории. Можно получить с помощью метода /v1/description-category/tree. |
| limit required | integer <int64> Количество значений в ответе:
|
| type_id required | integer <int64> Идентификатор типа товара. Можно получить с помощью метода /v1/description-category/tree. |
| value required | string Значение, по которому система будет искать справочные значения. Минимум — 2 символа. |
Array of objects Значения характеристики. | |||||||||
Array ()
| |||||||||
{- "attribute_id": 85,
- "description_category_id": 17054869,
- "limit": 100,
- "type_id": 97311,
- "value": "Name"
}{- "result": [
- {
- "id": 0,
- "info": "string",
- "picture": "string",
- "value": "string"
}
]
}Метод для создания товаров и обновления информации о них.
В сутки можно создать или обновить определённое количество товаров. Чтобы узнать лимит, используйте
/v4/product/info/limit. Если количество загрузок и обновлений товаров
превысит лимит, появится ошибка item_limit_exceeded.
В одном запросе можно передать до 100 товаров. Каждый товар — это отдельный элемент в массиве items. Укажите
всю информацию о товаре: его характеристики, штрихкод, изображения, габариты, цену и валюту цены.
При обновлении товара передайте в запросе всю информацию о нём.
Указанная валюта должна совпадать с той, которая установлена в настройках личного кабинета. По умолчанию передаётся RUB — российский рубль.
Например, если у вас установлена валюта юань, передавайте значение CNY, иначе вернётся ошибка.
Товар не будет создан или обновлён, если вы заполните неправильно или не укажете:
depth, width, height, dimension_unit, weight, weight_unit. Не пропускайте эти параметры в запросе и не указывайте 0.Для некоторых характеристик можно использовать HTML-теги.
После модерации товар появится в вашем личном кабинете, но не будет виден пользователям, пока вы не выставите его на продажу.
Каждый товар в запросе — отдельный элемент массива items.
Чтобы объединить две карточки, для каждой передайте 9048 в массиве attributes. Все атрибуты в этих карточках, кроме размера или цвета, должны совпадать.
Для загрузки передайте в запросе ссылки на изображения в общедоступном облачном хранилище. Формат изображения по ссылке — JPG или PNG.
Изображения в массиве images располагайте в соответствии с желаемым порядком на сайте. Для загрузки главного
изображения товара используйте параметр primary_image. Если не передать значение primary_image, главным будет
первое изображение в массиве images.
Для каждого товара вы можете загрузить до 30 изображений, включая главное.
Если передать значение primary_image, максимальное количество изображений в images — 29.
Если параметр primary_image пустой, то в images можно передать до 30 изображений.
Для загрузки изображений 360 используйте поле images360, для загрузки маркетингового цвета — color_image.
Если вы хотите изменить состав или порядок изображений, получите информацию с помощью метода
/v3/product/info/list — в нём отображается текущий порядок и
состав изображений. Скопируйте данные полей images, images360, color_image, измените и дополните состав или
порядок в соответствии с необходимостью.
Для загрузки передайте в запросе ссылки на видео.
Для этого в параметре complex_attributes передайте объект. В нём в массиве attributes передайте 2 объекта с complex_id = 100001:
В первом передайте укажите id = 21841 и в массиве values передайте объект с ссылкой на видео.
Пример:
{
"complex_id": 100001,
"id": 21841,
"values": [
{
"value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
}
]
}Во втором укажите значение id = 21837 и в массиве values передайте объект с названием видео.
Пример:
{
"complex_id": 100001,
"id": 21837,
"values": [
{
"value": "videoName_1"
}
]
}Если вы хотите загрузить несколько видео, передавайте значения для каждого видео в разных объектах массива values.
Пример:
{
"complex_id": 100001,
"id": 21837,
"values": [
{
"value": "videoName_1"
},
{
"value": "videoName_2"
}
]
},
{
"complex_id": 100001,
"id": 21841,
"values": [
{
"value": "https://www.youtube.com/watch?v=ZwM0iBn03dY"
},
{
"value": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
]
}Вы можете добавить в карточку товара таблицу размеров, созданную с помощью конструктора. Передайте её в массиве attributes в формате JSON как Rich-контент id = 13164.
Конструктор в формате JSON
Подробнее о конструкторе в Базе знаний продавца
Вы можете загрузить видеообложку через complex_attributes.
Пример:
"complex_attributes": [
{
"attributes": [
{
"id": 21845,
"complex_id": 100002,
"values": [
{
"dictionary_value_id": 0,
"value": "https://v.ozone.ru/vod/video-10/01GFATWQVCDE7G5B721421P1231Q7/asset_1.mp4"
}
]
}
]
}
]| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Массив данных. |
object Результаты запроса. | |||
| |||
{- "items": [
- {
- "attributes": [
- {
- "complex_id": 0,
- "id": 5076,
- "values": [
- {
- "dictionary_value_id": 971082156,
- "value": "Стойка для акустической системы"
}
]
}, - {
- "complex_id": 0,
- "id": 9048,
- "values": [
- {
- "value": "Комплект защитных плёнок для X3 NFC. Темный хлопок"
}
]
}, - {
- "complex_id": 0,
- "id": 8229,
- "values": [
- {
- "dictionary_value_id": 95911,
- "value": "Комплект защитных плёнок для X3 NFC. Темный хлопок"
}
]
}, - {
- "complex_id": 0,
- "id": 85,
- "values": [
- {
- "dictionary_value_id": 5060050,
- "value": "Samsung"
}
]
}, - {
- "complex_id": 0,
- "id": 10096,
- "values": [
- {
- "dictionary_value_id": 61576,
- "value": "серый"
}
]
}
], - "barcode": "112772873170",
- "description_category_id": 17028922,
- "new_description_category_id": 0,
- "color_image": "",
- "complex_attributes": [ ],
- "currency_code": "RUB",
- "depth": 10,
- "dimension_unit": "mm",
- "height": 250,
- "images": [ ],
- "images360": [ ],
- "name": "Комплект защитных плёнок для X3 NFC. Темный хлопок",
- "offer_id": "143210608",
- "old_price": "1100",
- "pdf_list": [ ],
- "price": "1000",
- "primary_image": "",
- "promotions": [
- {
- "operation": "UNKNOWN",
- "type": "REVIEWS_PROMO"
}
], - "type_id": 91565,
- "vat": "0.1",
- "weight": 100,
- "weight_unit": "g",
- "width": 150
}
]
}{- "result": {
- "task_id": 172549793
}
}Позволяет получить статус создания или обновления карточки товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| task_id required | integer <int64> Код задачи на импорт товаров. Можно получить с помощью метода /v3/product/import. |
object | |||||
| |||||
{- "task_id": "172549793"
}{- "result": {
- "items": [
- {
- "offer_id": "143210608",
- "product_id": 137285792,
- "status": "imported",
- "errors": [ ]
}
], - "total": 1
}
}Метод создаёт копию карточки товара с указанным SKU.
Создать копию не получится, если продавец запретил копирование своих карточек.
Обновить товар по SKU нельзя.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects <= 1000 items Информация о товарах. |
object | |||||
| |||||
{- "items": [
- {
- "sku": 298789742,
- "name": "string",
- "offer_id": "91132",
- "currency_code": "RUB",
- "old_price": "2590",
- "price": "2300",
- "vat": "0.1"
}
]
}{- "result": {
- "task_id": 176594213,
- "unmatched_sku_list": [ ]
}
}Метод позволяет добавлять характеристики и изменять их значения. Удалить уже заполненные характеристики не получится. Для полного обновления характеристик используйте /v3/product/import.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Товары и характеристики, которые нужно обновить. |
| task_id | integer <int64> Номер задания на обновление товаров. Чтобы проверить статус обновления, передайте полученное значение в метод /v1/product/import/info. |
{- "items": [
- {
- "attributes": [
- {
- "complex_id": 0,
- "id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "string"
}
]
}
], - "offer_id": "string"
}
]
}{- "task_id": 0
}Метод для загрузки или обновления изображений товара.
При каждом вызове метода передавайте все изображения, которые должны быть на карточке товара. Например, если вы вызвали метод и загрузили 10 изображений, а затем вызвали метод второй раз и загрузили ещё одно, то все 10 предыдущих сотрутся.
Для загрузки передайте адрес ссылки на изображение в общедоступном облачном хранилище. Формат изображения по ссылке — JPG или PNG.
Изображения в массиве images располагайте в соответствии с желаемым порядком на сайте. Главным будет
первое изображение в массиве.
Для каждого товара вы можете загрузить до 30 изображений.
Для загрузки изображений 360 используйте поле images360, для загрузки маркетингового цвета — color_image.
Если вы хотите изменить состав или порядок изображений, получите информацию с помощью метода
/v3/product/info/list — в нём отображается текущий порядок и
состав изображений. Скопируйте данные полей images, images360, color_image, измените и дополните состав или
порядок в соответствии с необходимостью.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| color_image | string Маркетинговый цвет. |
| images | Array of strings Массив ссылок на изображения. До 30 штук. Изображения в массиве расположены в порядке их расположения на сайте. Первое изображение в массиве будет главным. |
| images360 | Array of strings Массив изображений 360. До 70 штук. Формат: адрес ссылки на изображение в общедоступном облачном хранилище. Формат изображения по ссылке — JPG. |
| product_id required | integer <int64> Идентификатор товара в системе продавца — |
object Результат работы метода. | |||
| |||
{- "color_image": "string",
- "images": [
- "string"
], - "images360": [
- "string"
], - "product_id": 0
}{- "result": {
- "pictures": [
- {
- "is_360": true,
- "is_color": true,
- "is_primary": true,
- "product_id": 0,
- "state": "string",
- "url": "string"
}
]
}
}Метод для получения списка всех товаров.
Если вы используете фильтр по идентификатору offer_id или product_id, остальные параметры заполнять не обязательно.
За один раз вы можете использовать только одну группу идентификаторов, не больше 1000 товаров.
Если вы не используете для отображения идентификаторы, укажите limit и last_id в следующих запросах.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. При первом запросе оставьте это поле пустым. Чтобы получить следующие значения, укажите |
| limit | integer <int64> Количество значений на странице. Минимум — 1, максимум — 1000. |
object Результат. | |||||||
| |||||||
{- "filter": {
- "offer_id": [
- "136748"
], - "product_id": [
- "223681945"
], - "visibility": "ALL"
}, - "last_id": "",
- "limit": 100
}{- "result": {
- "items": [
- {
- "archived": true,
- "has_fbo_stocks": true,
- "has_fbs_stocks": true,
- "is_discounted": true,
- "offer_id": "136748",
- "product_id": 223681945,
- "quants": [
- {
- "quant_code": "string",
- "quant_size": 0
}
]
}
], - "total": 1,
- "last_id": "bnVсbA=="
}
}Метод для получения контент-рейтинга товаров, а также рекомендаций по его увеличению.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| skus required | Array of strings <int64> Идентификаторы товаров в системе Ozon — SKU, для которых нужно вернуть контент-рейтинг. |
Array of objects Контент-рейтинг товаров. | |||||||
Array ()
| |||||||
{- "skus": [
- "179737222"
]
}{- "products": [
- {
- "sku": 179737222,
- "rating": 42.5,
- "groups": [
- {
- "key": "media",
- "name": "Медиа",
- "rating": 70,
- "weight": 25,
- "conditions": [
- {
- "key": "media_images_2",
- "description": "Добавлено 2 изображения",
- "fulfilled": true,
- "cost": 50
}, - {
- "key": "media_images_3",
- "description": "Добавлено 3 изображения и более",
- "fulfilled": true,
- "cost": 20
}, - {
- "key": "media_image_3d",
- "description": "Добавлено 3D-изображение",
- "fulfilled": false,
- "cost": 15
}, - {
- "key": "media_video",
- "description": "Добавлено видео",
- "fulfilled": false,
- "cost": 15
}
], - "improve_attributes": [
- {
- "id": 4074,
- "name": "Код ролика на YouTube"
}, - {
- "id": 4080,
- "name": "3D-изображение"
}
], - "improve_at_least": 2
}, - {
- "key": "important_attributes",
- "name": "Важные атрибуты",
- "rating": 50,
- "weight": 30,
- "conditions": [
- {
- "key": "important_2",
- "description": "Заполнено 2 атрибута и более",
- "fulfilled": true,
- "cost": 50
}, - {
- "key": "important_50_percent",
- "description": "Заполнено более 50% атрибутов",
- "fulfilled": false,
- "cost": 25
}, - {
- "key": "important_70_percent",
- "description": "Заполнено более 70% атрибутов",
- "fulfilled": false,
- "cost": 25
}
], - "improve_attributes": [
- {
- "id": 4385,
- "name": "Гарантийный срок"
}, - {
- "id": 4389,
- "name": "Страна-изготовитель"
}, - {
- "id": 8513,
- "name": "Количество в упаковке, шт"
}, - {
- "id": 8590,
- "name": "Макс. диагональ, дюймы"
}, - {
- "id": 8591,
- "name": "Мин. диагональ, дюймы"
}, - {
- "id": 9336,
- "name": "Модель браслета/умных часов"
}, - {
- "id": 11046,
- "name": "Покрытие"
}, - {
- "id": 11047,
- "name": "Прозрачность покрытия"
}, - {
- "id": 11048,
- "name": "Дополнительные свойства покрытия"
}, - {
- "id": 11049,
- "name": "Вид стекла"
}, - {
- "id": 11603,
- "name": "Размер циферблата"
}
], - "improve_at_least": 6
}, - {
- "key": "other_attributes",
- "name": "Остальные атрибуты",
- "rating": 0,
- "weight": 25,
- "conditions": [
- {
- "key": "other_2",
- "description": "Заполнено 2 атрибута и более",
- "fulfilled": false,
- "cost": 50
}, - {
- "key": "other_50_percent",
- "description": "Заполнено более 50% атрибутов",
- "fulfilled": false,
- "cost": 50
}
], - "improve_attributes": [
- {
- "id": 4382,
- "name": "Размеры, мм"
}
], - "improve_at_least": 1
}, - {
- "key": "text",
- "name": "Текстовое описание",
- "rating": 50,
- "weight": 20,
- "conditions": [
- {
- "key": "text_annotation_100_chars",
- "description": "Аннотация более 100 знаков",
- "fulfilled": true,
- "cost": 25
}, - {
- "key": "text_annotation_500_chars",
- "description": "Аннотация более 500 знаков",
- "fulfilled": true,
- "cost": 25
}, - {
- "key": "text_rich",
- "description": "Заполнен Rich-контент",
- "fulfilled": false,
- "cost": 100
}
], - "improve_attributes": [
- {
- "id": 11254,
- "name": "Rich-контент JSON"
}
], - "improve_at_least": 1
}
]
}
]
}Метод для получения информации о товарах по их идентификаторам.
В теле запроса должен быть массив однотипных идентификаторов, в ответе будет массив items.
В одном запросе вы можете передать не больше 1000 товаров по параметрам offer_id, product_id и sku в сумме.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| offer_id | Array of strings Идентификатор товара в системе продавца — артикул. |
| product_id | Array of strings <int64> Идентификатор товара в системе продавца — |
| sku | Array of strings <int64> Идентификатор товара в системе Ozon — SKU. |
Array of objects Массив данных. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "offer_id": [
- "string"
], - "product_id": [
- "string"
], - "sku": [
- "string"
]
}{- "items": [
- {
- "availabilities": [
- {
- "availability": "string",
- "reasons": [
- {
- "human_text": {
- "text": "string"
}, - "id": 0
}
], - "sku": 0,
- "source": "string"
}
], - "barcodes": [
- "string"
], - "color_image": [
- "string"
], - "commissions": [
- {
- "delivery_amount": 0,
- "percent": 0,
- "return_amount": 0,
- "sale_schema": "string",
- "value": 0
}
], - "created_at": "2019-08-24T14:15:22Z",
- "currency_code": "string",
- "description_category_id": 0,
- "discounted_fbo_stocks": 0,
- "errors": [
- {
- "attribute_id": 0,
- "code": "string",
- "field": "string",
- "level": "ERROR_LEVEL_UNSPECIFIED",
- "state": "string",
- "texts": {
- "attribute_name": "string",
- "description": "string",
- "hint_code": "string",
- "message": "string",
- "params": [
- {
- "name": "string",
- "value": "string"
}
], - "short_description": "string"
}
}
], - "has_discounted_fbo_item": true,
- "id": 0,
- "images": [
- "string"
], - "images360": [
- "string"
], - "is_archived": true,
- "is_autoarchived": true,
- "is_discounted": true,
- "is_kgt": true,
- "is_prepayment_allowed": true,
- "is_super": true,
- "min_price": "string",
- "model_info": {
- "count": 0,
- "model_id": 0
}, - "name": "string",
- "offer_id": "string",
- "old_price": "string",
- "price": "string",
- "price_indexes": {
- "color_index": "COLOR_INDEX_UNSPECIFIED",
- "external_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}, - "self_marketplaces_index_data": {
- "minimal_price": "string",
- "minimal_price_currency": "string",
- "price_index_value": 0
}
}, - "primary_image": [
- "string"
], - "promotions": [
- {
- "is_enabled": true,
- "type": "UNSPECIFIED"
}
], - "sku": 0,
- "sources": [
- {
- "created_at": "2019-08-24T14:15:22Z",
- "quant_code": "string",
- "shipment_type": "SHIPMENT_TYPE_UNSPECIFIED",
- "sku": 0,
- "source": "string"
}
], - "statuses": {
- "is_created": true,
- "moderate_status": "string",
- "status": "string",
- "status_description": "string",
- "status_failed": "string",
- "status_name": "string",
- "status_tooltip": "string",
- "status_updated_at": "2019-08-24T14:15:22Z",
- "validation_status": "string"
}, - "stocks": {
- "has_stock": true,
- "stocks": [
- {
- "present": 0,
- "reserved": 0,
- "sku": 0,
- "source": "string"
}
]
}, - "type_id": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "vat": "string",
- "visibility_details": {
- "has_price": true,
- "has_stock": true
}, - "volume_weight": 0
}
]
}Возвращает описание характеристик товаров по идентификатору и видимости. Товар можно искать по offer_id, product_id или sku.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по товарам. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений на странице. |
| sort_by | string Параметр, по которому товары будут отсортированы:
|
| sort_dir | string Направление сортировки:
|
Array of objects Результаты запроса. | |||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, укажите полученное значение в следующем запросе в параметре | ||||||||||||||||||||||||||||||||||||||||||||
| total | string <int64> Количество товаров в списке. | ||||||||||||||||||||||||||||||||||||||||||||
{- "filter": {
- "product_id": [
- "213761435"
], - "offer_id": [
- "testtest5"
], - "sku": [
- "123495432"
], - "visibility": "ALL"
}, - "limit": 100,
- "sort_dir": "ASC"
}{- "result": [
- {
- "id": 213761435,
- "barcode": "",
- "barcodes": [
- "123124123",
- "123342455"
], - "name": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G",
- "offer_id": "21470",
- "type_id": 124572394,
- "height": 10,
- "depth": 210,
- "width": 140,
- "dimension_unit": "mm",
- "weight": 50,
- "weight_unit": "g",
- "sku": 423434534,
- "model_info": {
- "model_id": 43445453,
- "count": 4
}, - "pdf_list": [ ],
- "attributes": [
- {
- "id": 5219,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970718176,
- "value": "универсальный"
}
]
}, - {
- "id": 11051,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970736931,
- "value": "Прозрачный"
}
]
}, - {
- "id": 10100,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "false"
}
]
}, - {
- "id": 11794,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 970860783,
- "value": "safe"
}
]
}, - {
- "id": 9048,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
}
]
}, - {
- "id": 5076,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 39638,
- "value": "Xiaomi"
}
]
}, - {
- "id": 9024,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "21470"
}
]
}, - {
- "id": 10015,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "false"
}
]
}, - {
- "id": 85,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 971034861,
- "value": "Brand"
}
]
}, - {
- "id": 9461,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 349824787,
- "value": "Защитная пленка для смартфона"
}
]
}, - {
- "id": 4180,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка защитная для Xiaomi Redmi Note 10 Pro 5G"
}
]
}, - {
- "id": 4191,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 0,
- "value": "Пленка предназначена для модели Xiaomi Redmi Note 10 Pro 5G. Защитная гидрогелевая пленка обеспечит защиту вашего смартфона от царапин, пыли, сколов и потертостей."
}
]
}, - {
- "id": 8229,
- "complex_id": 0,
- "values": [
- {
- "dictionary_value_id": 91521,
- "value": "Защитная пленка"
}
]
}
], - "attributes_with_defaults": [
- 5435,
- 3452
], - "complex_attributes": [ ],
- "color_image": "",
- "description_category_id": 71107562
}
], - "total": 1,
- "last_id": "onVsfA=="
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| offer_id required | string Идентификатор товара в системе продавца — артикул. |
| product_id | integer <int64> Идентификатор товара в системе продавца — |
object | |||||||||
| |||||||||
{- "offer_id": "5",
- "product_id": 73453843
}{- "result": {
- "id": 73453843,
- "offer_id": "5",
- "name": "Онлайн курс по дрессировке собак \"Воспитанная собака за 3 недели\"",
- "description": "Экспресс-курс - это сокращённый вариант курса \"Собака: инструкция по применению\", дающий базовый минимум знаний, навыков, умений. Это оптимальный вариант для совершения первых шагов по воспитанию!<br/><br/>Что дает Экспресс-курс:<ul><li>Контакт с собакой </li></ul>К концу экспресс-курса дрессировки вы получаете воспитанного друга и соратника, который ориентируется на вас в любой ситуации.<ul><li>Уверенность в безопасности</li></ul>Благополучие собаки: больше не будет срывов с поводка, преследования кошек, попыток съесть что-либо на улице и т. д.<ul><li>Комфортная жизнь</li></ul>Принципиально другой уровень общения, без раздражения, криков и недовольства поведением животного."
}
}Метод для получения информации о лимитах:
Если у вас есть лимит на ассортимент и вы израсходуете его, вы не сможете создавать новые товары.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Суточный лимит на создание товаров. | |
object Суточный лимит на обновление товаров. | |
object Лимит на ассортимент. |
{ }{- "daily_create": {
- "limit": 0,
- "reset_at": "2019-08-24T14:15:22Z",
- "usage": 0
}, - "daily_update": {
- "limit": 0,
- "reset_at": "2019-08-24T14:15:22Z",
- "usage": 0
}, - "total": {
- "limit": 0,
- "usage": 0
}
}Метод для изменения offer_id, привязанных к товарам. Вы можете изменить несколько offer_id.
Рекомендуем передавать до 250 значений в массиве.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Список пар с новыми и старыми значениями артикулов. |
Array of objects Список ошибок. | |||||
Array ()
| |||||
{- "update_offer_id": [
- {
- "new_offer_id": "string",
- "offer_id": "string"
}
]
}{- "errors": [
- {
- "message": "string",
- "offer_id": "string"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id required | Array of integers <int64> Список идентификаторов товаров в системе продавца — |
| result | boolean Результат обработки запроса. |
{- "product_id": [
- "125529926"
]
}{- "result": true
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id required | Array of integers <int64> Список идентификаторов товаров в системе продавца — В сутки можно восстановить из архива не больше 10 товаров, которые были архивированы автоматически. |
| result | boolean Результат обработки запроса. |
{- "product_id": [
- "125529926"
]
}{- "result": true
}В одном запросе можно передать до 500 идентификаторов.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Идентификатор товара в системе продавца — |
Array of objects Статус обработки запроса. | |||||||
Array ()
| |||||||
{- "products": [
- {
- "offer_id": "033"
}
]
}{- "status": [
- {
- "offer_id": "033",
- "is_deleted": true,
- "error": ""
}
]
}Метод для получения количества пользователей, которые нажали Узнать о поступлении на странице товара.
Вы можете передать несколько товаров в запросе.
| skus required | Array of strings <int64> Список SKU, идентификаторов товара в системе Ozon. |
Array of objects Результат работы метода. | |||||
Array ()
| |||||
{- "skus": [
- "string"
]
}{- "result": [
- {
- "count": 0,
- "sku": 0
}
]
}Метод для получения единого SKU по старым идентификаторам SKU FBS и SKU FBO. В ответе будут все SKU, связанные с переданными.
Метод может обработать любые SKU, даже скрытые или удалённые.
Передавайте до 200 SKU в одном запросе.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| sku required | Array of strings <int64> Список SKU. |
Array of objects Информация о связанных SKU. | |
Array of objects Ошибки. |
{- "sku": [
- "string"
]
}{- "items": [
- {
- "availability": "string",
- "deleted_at": "2019-08-24T14:15:22Z",
- "delivery_schema": "string",
- "product_id": 0,
- "sku": 0
}
], - "errors": [
- {
- "code": "string",
- "sku": 0,
- "message": "string"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_id required | Array of strings <int64> <= 1000 items Список идентификаторов товаров в системе продавца — |
Array of objects Изображения товаров. | |||||||||||||
Array ()
| |||||||||||||
{- "product_id": [
- "string"
]
}{- "items": [
- {
- "product_id": 0,
- "primary_photo": [
- "string"
], - "photo": [
- "string"
], - "color_photo": [
- "string"
], - "photo_360": [
- "string"
], - "errors": [
- {
- "message": "string",
- "url": "string"
}
]
}
]
}Если у товара есть штрихкод, который не указан в системе Ozon, привяжите его с помощью этого метода. Если штрихкода нет, вы можете создать его через метод /v1/barcode/generate.
На одном товаре может быть до 100 штрихкодов. С одного аккаунта продавца можно использовать метод не больше 20 раз в минуту.
required | Array of objects <= 100 items Список штрихкодов и товаров. |
Array of objects Список ошибок. | |||||||||
Array ()
| |||||||||
{- "barcodes": [
- {
- "barcode": "string",
- "sku": 0
}
]
}{- "errors": [
- {
- "code": "string",
- "error": "string",
- "barcode": "string",
- "sku": 0
}
]
}Если у товара нет штрихкода, вы можете создать его с помощью этого метода. Если штрихкод уже есть, но он не указан в системе Ozon, вы можете привязать его через метод /v1/barcode/add.
За один запрос вы можете создать штрихкоды не больше чем для 100 товаров. С одного аккаунта продавца можно использовать метод не больше 20 раз в минуту.
| product_ids required | Array of strings <int64> Идентификаторы товаров, для которых нужно создать штрихкод. |
Array of objects Ошибки при создании штрихкода. | |||||||||
Array ()
| |||||||||
{- "product_ids": [
- "string"
]
}{- "errors": [
- {
- "code": "string",
- "error": "string",
- "barcode": "string",
- "product_id": 0
}
]
}Позволяет изменить информацию о количестве товара в наличии.
За один запрос можно изменить наличие для 100 пар товар-склад. С одного аккаунта продавца можно отправить до 80 запросов в минуту.
Вы можете задать наличие товара только после того, как его статус сменится на price_sent.
Остатки крупногабаритных товаров можно обновлять только на предназначенных для них складах.
Если запрос содержит оба параметра — offer_id и product_id, изменения применятся к товару с offer_id. Для избежания неоднозначности используйте только один из параметров.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Информация о товарах на складах. |
Array of objects | |||||||||||
Array ()
| |||||||||||
{- "stocks": [
- {
- "offer_id": "PH11042",
- "product_id": 313455276,
- "stock": 100,
- "warehouse_id": 22142605386000
}
]
}{- "result": [
- {
- "warehouse_id": 22142605386000,
- "product_id": 118597312,
- "offer_id": "PH11042",
- "updated": true,
- "errors": [ ]
}
]
}Возвращает информацию о ĸоличестве товаров по схемам FBS и rFBS:
Чтобы получить информацию об остатках по схеме FBO, используйте метод /v1/analytics/stocks.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
required | object Фильтр по товарам. |
| limit required | integer <int32> Количество значений на странице. Минимум — 1, максимум — 1000. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Информация о товарах. | |
| total | integer <int32> Количество уникальных товаров, для которых выводится информация об остатках. |
{- "cursor": "",
- "filter": {
- "offer_id": [
- "string"
], - "product_id": [
- "313455276"
], - "visibility": "ALL",
- "with_quant": {
- "created": true,
- "exists": true
}
}, - "limit": 100
}{- "cursor": "string",
- "items": [
- {
- "offer_id": "string",
- "product_id": 0,
- "stocks": [
- {
- "present": 0,
- "reserved": 0,
- "shipment_type": "SHIPMENT_TYPE_GENERAL",
- "sku": 0,
- "type": "string",
- "warehouse_ids": [
- 0
]
}
]
}
], - "total": 0
}| cursor | string Указатель для выборки следующих данных. |
| limit required | integer <int64> [ 1 .. 1000 ] Количество значений на странице. |
| warehouse_id required | integer <int64> Идентификатор склада. |
| cursor | string Указатель для выборки следующих данных. Если параметр пустой, данных больше нет. |
| has_next | boolean Признак, что в ответе вернули не все товары:
|
Array of objects Информация об остатках товара. |
{- "cursor": "",
- "limit": 10,
- "warehouse_id": 1020003080073000
}{- "stocks": [
- {
- "sku": 147035011,
- "product_id": 28743,
- "offer_id": "02105020-35",
- "warehouse_id": 1020003080073000,
- "present": 1000,
- "reserved": 0,
- "free_stock": 1000,
- "updated_at": "2025-09-15T10:36:24.417498Z"
}
], - "has_next": false,
- "cursor": "147035011"
}Передайте в запросе offer_id или sku. Если укажете оба, будет использован только sku.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| sku required | Array of strings <int64> Идентификатор товара в системе Ozon — SKU. |
| offer_id | Array of strings <int64> Идентификатор товара в системе продавца — артикул. |
Array of objects Результат работы метода. | |||||||||||||||
Array ()
| |||||||||||||||
{- "sku": [
- "string"
], - "offer_id": [
- "string"
]
}{- "result": [
- {
- "sku": 0,
- "offer_id": "string",
- "present": 0,
- "product_id": 0,
- "reserved": 0,
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Позволяет изменить цену одного или нескольких товаров.
Цену каждого товара можно обновлять не больше 10 раз в час.
Чтобы сбросить old_price, поставьте 0 у этого параметра.
Если у товара установлена минимальная цена и включено автоприменение в акции, отключите его и обновите
минимальную цену. Иначе вернётся ошибка action_price_enabled_min_price_missing.
Если запрос содержит оба параметра — offer_id и product_id, изменения применятся к товару с offer_id. Для избежания неоднозначности используйте только один из параметров.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects <= 1000 items Информация о ценах товаров. |
Array of objects Результаты запроса. | |||||||||
Array ()
| |||||||||
{- "prices": [
- {
- "auto_action_enabled": "UNKNOWN",
- "auto_add_to_ozon_actions_list_enabled": "UNKNOWN",
- "currency_code": "RUB",
- "manage_elastic_boosting_through_price": true,
- "min_price": "800",
- "min_price_for_auto_actions_enabled": true,
- "net_price": "650",
- "offer_id": "",
- "old_price": "0",
- "price": "1448",
- "price_strategy_enabled": "UNKNOWN",
- "product_id": 1386,
- "quant_size": 1,
- "vat": "0.1"
}
]
}{- "result": [
- {
- "product_id": 1386,
- "offer_id": "PH8865",
- "updated": true,
- "errors": [ ]
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_ids | number <= 1000 Список идентификаторов товаров в системе продавца — |
{- "product_ids": 0
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| product_ids | number <= 1000 Список идентификаторов товаров в системе продавца — |
Array of objects | |||||||
Array ()
| |||||||
{- "product_ids": 0
}{- "statuses": [
- {
- "expired_at": "2019-08-24T14:15:22Z",
- "min_price_for_auto_actions_enabled": true,
- "product_id": 0
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
required | object Фильтр по товарам. |
| limit required | integer <int32> [ 1 .. 1000 ] Количество значений на странице. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Список товаров. | |
| total | integer <int32> Количество товаров в списке. |
{- "cursor": "",
- "filter": {
- "offer_id": [
- "356792"
], - "product_id": [
- "243686911"
], - "visibility": "ALL"
}, - "limit": 100
}{- "cursor": "string",
- "items": [
- {
- "acquiring": 0,
- "commissions": {
- "fbo_deliv_to_customer_amount": 14.75,
- "fbo_direct_flow_trans_max_amount": 46.5,
- "fbo_direct_flow_trans_min_amount": 31,
- "fbo_return_flow_amount": 50,
- "fbs_deliv_to_customer_amount": 60,
- "fbs_direct_flow_trans_max_amount": 61.5,
- "fbs_direct_flow_trans_min_amount": 41,
- "fbs_first_mile_max_amount": 25,
- "fbs_first_mile_min_amount": 0,
- "fbs_return_flow_amount": 40,
- "sales_percent_fbo": 15,
- "sales_percent_fbp": 0,
- "sales_percent_fbs": 0,
- "sales_percent_rfbs": 0
}, - "marketing_actions": {
- "actions": [
- {
- "date_from": "2024-12-13T06:49:37.591Z",
- "date_to": "2024-12-13T06:49:37.591Z",
- "title": "string",
- "value": 0
}
], - "current_period_from": "2024-12-13T06:49:37.591Z",
- "current_period_to": "2024-12-13T06:49:37.591Z",
- "ozon_actions_exist": true
}, - "offer_id": "356792",
- "price": {
- "auto_action_enabled": true,
- "auto_add_to_ozon_actions_list_enabled": true,
- "currency_code": "RUB",
- "marketing_seller_price": 0,
- "min_price": 0,
- "net_price": 0,
- "old_price": 579,
- "price": 499,
- "retail_price": 0,
- "vat": 0.2
}, - "price_indexes": {
- "color_index": "WITHOUT_INDEX",
- "external_index_data": {
- "min_price": 0,
- "min_price_currency": "string",
- "price_index_value": 0
}, - "ozon_index_data": {
- "min_price": 0,
- "min_price_currency": "string",
- "price_index_value": 0
}, - "self_marketplaces_index_data": {
- "min_price": 0,
- "min_price_currency": "string",
- "price_index_value": 0
}
}, - "product_id": 243686911,
- "volume_weight": 0
}
], - "total": 0
}Метод для получения информации о состоянии и дефектах уценённого товара по его SKU. Работает только с уценёнными товарами по схеме FBO. Также метод возвращает SKU основного товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| discounted_skus required | Array of strings <int64> Список SKU уценённых товаров. |
Array of objects Информация об уценке и основном товаре. | |||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||
{- "discounted_skus": [
- "635548518"
]
}{- "items": [
- {
- "discounted_sku": 635548518,
- "sku": 320067758,
- "condition_estimation": "4",
- "packaging_violation": "",
- "warranty_type": "",
- "reason_damaged": "Механическое повреждение",
- "comment_reason_damaged": "повреждена заводская упаковка",
- "defects": "",
- "mechanical_damage": "",
- "package_damage": "",
- "shortage": "",
- "repair": "",
- "condition": ""
}
]
}Метод для установки размера скидки на уценённые товары, продающиеся по схеме FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| discount required | integer <int32> Размер скидки: от 3 до 99 процентов. |
| product_id required | integer <int64> Идентификатор товара в системе продавца — |
| result | boolean Результат работы метода. |
{- "discount": 0,
- "product_id": 0
}{- "result": true
}Для продвижения товаров участвуйте в акциях, которые Ozon проводит для покупателей. Подробнее об акциях в Базе знаний продавца.
Метод для получения списка акций Ozon, в которых можно участвовать.
Array of objects Результаты запроса. | |||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||
{- "result": [
- {
- "id": 71342,
- "title": "test voucher #2",
- "date_start": "2021-11-22T09:46:38Z",
- "date_end": "2021-11-30T20:59:59Z",
- "potential_products_count": 0,
- "is_participating": true,
- "participating_products_count": 5,
- "description": "",
- "action_type": "DISCOUNT",
- "banned_products_count": 0,
- "with_targeting": false,
- "discount_type": "UNKNOWN",
- "discount_value": 0,
- "order_amount": 0,
- "freeze_date": "",
- "is_voucher_action": true
}
]
}Метод для получения списка товаров, которые могут участвовать в акции, по её идентификатору.
| action_id required | number <double> Идентификатор акции. Можно получить с помощью метода /v1/actions. |
| limit | number <double> Количество ответов на странице. По умолчанию — 100. |
| offset required | number <double> Deprecated Количество элементов, которое будет пропущено в ответе. Например, если |
| last_id | number <double> Идентификатор последнего значения на странице. При первом запросе оставьте это поле пустым. |
object Результаты запроса. | |||||||
| |||||||
{- "action_id": 63337,
- "limit": 10,
- "offset": 0,
- "last_id": "bnVсbA=="
}{- "result": {
- "products": [
- {
- "id": 226,
- "price": 250,
- "action_price": 0,
- "alert_max_action_price_failed": true,
- "alert_max_action_price": 31,
- "max_action_price": 175,
- "add_mode": "NOT_SET",
- "stock": 0,
- "min_stock": 0
}, - {
- "id": 1366,
- "price": 2300,
- "action_price": 630,
- "alert_max_action_price_failed": true,
- "alert_max_action_price": 31,
- "max_action_price": 770,
- "add_mode": "MANUAL",
- "stock": 0,
- "min_stock": 0,
- "current_boost": 0,
- "price_min_elastic": 0,
- "price_max_elastic": 0,
- "min_boost": 0,
- "max_boost": 0
}
], - "total": 2,
- "last_id": "bnVсbA=="
}
}Метод для получения списка товаров, участвующих в акции, по её идентификатору.
| action_id required | number <double> Идентификатор акции. Можно получить с помощью метода /v1/actions. |
| limit | number <double> Количество ответов на странице. По умолчанию — 100. |
| offset required | number <double> Deprecated Количество элементов, которое будет пропущено в ответе. Например, если |
| last_id | number <double> Идентификатор последнего значения на странице. При первом запросе оставьте это поле пустым. |
object Результаты запроса. | |||||||
| |||||||
{- "action_id": 66011,
- "limit": 10,
- "offset": 0,
- "last_id": "bnVсbA=="
}{- "result": {
- "products": [
- {
- "id": 28745,
- "price": 99,
- "action_price": 50,
- "alert_max_action_price_failed": true,
- "alert_max_action_price": 31,
- "max_action_price": 32,
- "add_mode": "MANUAL",
- "stock": 20,
- "min_stock": 0,
- "current_boost": 0,
- "price_min_elastic": 0,
- "price_max_elastic": 0,
- "min_boost": 0,
- "max_boost": 0
}
], - "total": 263,
- "last_id": "bnVсbA=="
}
}Метод для добавления товаров в доступную акцию.
| action_id required | number <double> Идентификатор акции. Можно получить с помощью метода /v1/actions. |
required | Array of objects <= 1000 items Список товаров. |
object Результаты запроса. | |||||
| |||||
{- "action_id": 60564,
- "products": [
- {
- "action_price": 356,
- "product_id": 1389,
- "stock": 10
}
]
}{- "result": {
- "product_ids": [
- 1389
], - "rejected": [ ]
}
}Метод для удаления товаров из акции.
| action_id required | number <double> Идентификатор акции. Можно получить с помощью метода /v1/actions. |
| product_ids required | Array of numbers <double> Список идентификаторов товаров в системе продавца — |
object Результаты запроса. | |||||
| |||||
{- "action_id": 66011,
- "product_ids": [
- 14975
]
}{- "result": {
- "product_ids": [
- 14975
], - "rejected": [ ]
}
}Метод для получения списка товаров, которые покупатели хотят купить со скидкой.
| status required | string Default: "UNKNOWN" Enum: "NEW" "SEEN" "APPROVED" "PARTLY_APPROVED" "DECLINED" "AUTO_DECLINED" "DECLINED_BY_USER" "COUPON" "PURCHASED" Статус заявки на скидку:
|
| page | integer <uint64> Страница, с которой нужно выгрузить список заявок на скидку. |
| limit required | integer <uint64> Максимальное количество заявок на странице. |
Array of objects Список заявок. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "status": "UNKNOWN",
- "page": 1,
- "limit": 50
}{- "result": [
- {
- "id": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "end_at": "2019-08-24T14:15:22Z",
- "edited_till": "2019-08-24T14:15:22Z",
- "status": "string",
- "customer_name": "string",
- "sku": 0,
- "user_comment": "string",
- "seller_comment": "string",
- "requested_price": 0,
- "approved_price": 0,
- "original_price": 0,
- "discount": 0,
- "discount_percent": 0,
- "base_price": 0,
- "min_auto_price": 0,
- "prev_task_id": 0,
- "is_damaged": true,
- "moderated_at": "2019-08-24T14:15:22Z",
- "approved_discount": 0,
- "approved_discount_percent": 0,
- "is_purchased": true,
- "is_auto_moderated": true,
- "offer_id": "string",
- "email": "string",
- "last_name": "string",
- "first_name": "string",
- "patronymic": "string",
- "approved_quantity_min": 0,
- "approved_quantity_max": 0,
- "requested_quantity_min": 0,
- "requested_quantity_max": 0,
- "requested_price_with_fee": 0,
- "approved_price_with_fee": 0,
- "approved_price_fee_percent": 0
}
]
}Вы можете согласовывать заявки в статусах: NEW — новые, SEEN — просмотренные.
required | Array of objects Список заявок. |
object Результат работы метода. | |||||||
| |||||||
{- "tasks": [
- {
- "id": 0,
- "approved_price": 0,
- "seller_comment": "string",
- "approved_quantity_min": 0,
- "approved_quantity_max": 0
}
]
}{- "result": {
- "fail_details": [
- {
- "task_id": 0,
- "error_for_user": "string"
}
], - "success_count": 0,
- "fail_count": 0
}
}Вы можете отклонить заявки в статусах: NEW — новые, SEEN — просмотренные.
required | Array of objects Список заявок. |
object Результат работы метода. | |||||||
| |||||||
{- "tasks": [
- {
- "id": 0,
- "seller_comment": "string"
}
]
}{- "result": {
- "fail_details": [
- {
- "task_id": 0,
- "error_for_user": "string"
}
], - "success_count": 0,
- "fail_count": 0
}
}Метод для получения списка конкурентов — продавцов с похожими товарами в других интернет-магазинах и маркетплейсах.
| page required | integer <int64> Страница списка, с которой нужно выгрузить конкурентов. Минимальное значение — |
| limit required | integer <int64> Максимальное количество конкурентов на странице. Допустимы значения от |
Array of objects Список конкурентов. | |
| total | integer <int32> Общее количество конкурентов. |
{- "page": 1,
- "limit": 20
}{- "competitor": [
- {
- "competitor_name": "string",
- "competitor_id": 0
}
], - "total": 0
}| page required | integer <int64> Страница списка, с которой нужно выгрузить стратегии. Минимальное значение — |
| limit required | integer <int64> Максимальное количество стратегий на странице. Допустимые значения — от |
Array of objects Список стратегий. | |
| total | integer <int32> Общее количество стратегий. |
{- "page": 1,
- "limit": 20
}{- "strategies": [
- {
- "strategy_id": "string",
- "strategy_name": "string",
- "type": "string",
- "update_type": "string",
- "updated_at": "string",
- "products_count": 0,
- "competitors_count": 0,
- "enabled": true
}
], - "total": 0
} required | Array of objects Список конкурентов. |
| strategy_name required | string Название стратегии. |
object Результат работы метода. | |||
| |||
{- "strategy_name": "Новая стратегия",
- "competitors": [
- {
- "competitor_id": 1008426,
- "coefficient": 1
}, - {
- "competitor_id": 204,
- "coefficient": 1
}, - {
- "competitor_id": 91,
- "coefficient": 1
}, - {
- "competitor_id": 48,
- "coefficient": 1
}
], - "company_id": 7
}{- "result": {
- "id": "4f3a1d4c-5833-4f04-b69b-495cbc1f6f1c"
}
}| strategy_id required | string Идентификатор стратегии. |
object Результат работы метода. | |||||||||||
| |||||||||||
{- "strategy_id": "string"
}{- "result": {
- "strategy_name": "тест1",
- "enabled": true,
- "update_type": "strategyItemsListChanged",
- "type": "COMP_PRICE",
- "competitors": [
- {
- "competitor_id": 204,
- "coefficient": 1
}, - {
- "competitor_id": 1008426,
- "coefficient": 1
}
]
}
}Можно обновить все стратегии кроме системной.
required | Array of objects Список конкурентов. |
| strategy_id required | string Идентификатор стратегии. |
| strategy_name required | string Название стратегии. |
{- "strategy_id": "a3de1826-9c54-40f1-bb6d-1a9e2638b058",
- "strategy_name": "Новая стратегия",
- "competitors": [
- {
- "competitor_id": 1008426,
- "coefficient": 1
}, - {
- "competitor_id": 204,
- "coefficient": 1
}, - {
- "competitor_id": 91,
- "coefficient": 1
}, - {
- "competitor_id": 48,
- "coefficient": 1
}, - {
- "competitor_id": 45,
- "coefficient": 1
}
]
}{ }| product_id required | Array of strings <int64> Список идентификаторов товаров в системе продавца — |
| strategy_id required | string Идентификатор стратегии. |
object Результат работы метода. | |||||
| |||||
{- "product_id": [
- "29209"
], - "strategy_id": "e29114f0-177d-4160-8d06-2bc528470dda"
}{- "result": {
- "failed_product_count": 0
}
}| product_id required | Array of strings <int64> Список идентификаторов товаров в системе продавца — |
object Результат работы метода. | |||
| |||
{- "product_id": [
- "string"
]
}{- "result": {
- "products_info": [
- {
- "product_id": 29209,
- "strategy_id": "b7cd30e6-5667-424d-b105-fbec30a52477"
}
]
}
}| strategy_id required | string Идентификатор стратегии. |
object Список товаров. | |||
| |||
{- "strategy_id": "string"
}{- "result": {
- "product_id": [
- "string"
]
}
}Если вы добавили товар в стратегию ценообразования, метод вернёт цену и ссылку на товар у конкурента.
| product_id required | integer <int64> Идентификатор товара в системе продавца — |
object Результат работы метода. | |||||||||||||
| |||||||||||||
{- "product_id": 0
}{- "result": {
- "strategy_id": "string",
- "is_enabled": true,
- "strategy_product_price": 0,
- "price_downloaded_at": "2022-11-17T15:33:53.936Z",
- "strategy_competitor_id": 0,
- "strategy_competitor_product_url": "string"
}
}| product_id required | Array of strings <int64> Список идентификаторов товаров в системе продавца — |
object Результат работы метода. | |||
| |||
{- "product_id": [
- "string"
]
}{- "result": {
- "failed_product_count": 0
}
}Можно изменить статус любой стратегии кроме системной.
| enabled | boolean Статус стратегии:
|
| strategy_id required | string Идентификатор стратегии. |
{- "strategy_id": "c7516438-7124-4e2c-85d3-ccd92b6b9b65",
- "enabled": true
}{ }Можно удалить любую стратегию кроме системной.
| strategy_id required | string Идентификатор стратегии. |
{- "strategy_id": "string"
}{ }Метод для получения списка брендов, для которых требуется предоставить сертификат. Ответ содержит список брендов, товары которых есть в вашем личном кабинете.
Список брендов может изменяться, если Ozon получит требование от бренда предоставлять сертификат.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page required | integer <int32> Номер страницы, возвращаемой в запросе. |
| page_size required | integer <int32> Количество элементов на странице. |
object Результат запроса. | |||||
| |||||
{- "page": 1,
- "page_size": 50
}{- "result": {
- "brand_certification": [
- {
- "brand_id": 135476863,
- "brand_name": "Sea of Spa",
- "has_certificate": false
}
], - "total": 1
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список типов и названий сертификатов. | |||||
Array ()
| |||||
{- "result": [
- {
- "name": "ГОСТ",
- "value": "gost"
}, - {
- "name": "Технический регламент РФ",
- "value": "technical_regulations_rf"
}, - {
- "name": "Технический регламент ТС",
- "value": "technical_regulations_cu"
}
]
}object Список типов соответствия требованиям. | |||||
| |||||
{- "result": {
- "base": [
- {
- "code": "string",
- "title": "string"
}
], - "hazard": [
- {
- "code": "string",
- "title": "string"
}
]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список типов и названий сертификатов. | |||||
Array ()
| |||||
{- "result": [
- {
- "name": "Сертификат соответствия",
- "value": "certificate_of_conformity"
}, - {
- "name": "Декларация о соответствии",
- "value": "declaration"
}, - {
- "name": "Свидетельство о регистрации",
- "value": "certificate_of_registration"
}, - {
- "name": "Регистрационное удостоверение",
- "value": "registration_certificate"
}, - {
- "name": "Отказное письмо",
- "value": "refused_letter"
}, - {
- "name": "Ветеринарное свидетельство",
- "value": "veterinary_cover_document"
}, - {
- "name": "Паспорт безопасности",
- "value": "safety_data_sheet"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page required | integer <int64> Номер страницы. |
| page_size required | integer <int64> [ 1 .. 1000 ] Количество элементов на странице. |
Array of objects Информация о сертифицируемых категориях. | |
| total | integer <int64> Всего категорий. |
{- "page": 1,
- "page_size": 100
}{- "certification": [
- {
- "category_id": 0,
- "category_name": "string",
- "is_required": true,
- "type_id": 0,
- "type_name": "string"
}
], - "total": 0
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page | integer <int32> Номер страницы, возвращаемой в запросе. |
| page_size | integer <int32> Количество элементов на странице. |
object Результат запроса. | |||||
| |||||
{- "page": 1,
- "page_size": 100
}{- "result": {
- "certification": [
- {
- "is_required": true,
- "category_name": "Витаминно-минеральные комплексы для взрослых"
}
], - "total": 1
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| files required | Array of file Массив сертификатов для товара. Допустимые расширения jpg, jpeg, png, pdf. |
| name required | string Название сертификата. Максимум 100 символов. |
| number required | string Номер сертификата. Максимум 100 символов. |
| type_code required | string Enum: "certificate_of_conformity" "declaration" "certificate_of_registration" "registration_certificate" "refused_letter" "veterinary_cover_document" "safety_data_sheet" Тип сертификата. Чтобы получить доступные типы, используйте метод GET /v1/product/certificate/types. |
| accordance_type_code | string Enum: "technical_regulations_rf" "technical_regulations_cu" "gost" Тип соответствия требованиям. Чтобы получить доступные типы, используйте метод GET /v1/product/certificate/accordance-types. Параметр обязательный, если |
| issue_date required | string <date-time> Default: "2021-04-30T11:31:26Z" Дата начала действия сертификата. |
| expire_date | string <date-time> Дата окончания действия сертификата. Может быть пустым для бессрочных сертификатов. Формат: |
{- "id": 50058
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| certificate_id | integer <int64> Идентификатор сертификата, который был присвоен при его загрузке. |
| product_id | Array of integers <int64> Массив идентификаторов товаров, к которым относится этот сертификат. |
| result | boolean Результат обработки запроса. |
{- "certificate_id": 50058,
- "product_id": [
- 290
]
}{- "result": true
}| certificate_id required | integer <int32> Идентификатор сертификата. |
object Результат удаления сертификата. | |||||
| |||||
{- "certificate_id": 0
}{- "result": {
- "is_delete": true,
- "error_message": "string"
}
}| certificate_number required | string Идентификатор сертификата. |
object Информация о сертификате. | |||||||||||||||||||||||
| |||||||||||||||||||||||
{- "certificate_number": "string"
}{- "result": {
- "certificate_id": 0,
- "certificate_number": "string",
- "certificate_name": "string",
- "type_code": "string",
- "status_code": "string",
- "accordance_type_code": "string",
- "rejection_reason_code": "string",
- "verification_comment": "string",
- "issue_date": "2019-08-24T14:15:22Z",
- "expire_date": "2019-08-24T14:15:22Z",
- "products_count": 0
}
}| offer_id | string Идентификатор товара в системе продавца — артикул, привязанный к сертификату. Передайте параметр, если нужны сертификаты, к которым привязаны определённые товары. |
| status | string Статус сертификата. Передайте параметр, если нужны сертификаты с определённым статусом. |
| type | string Тип сертификата. Передайте параметр, если нужны сертификаты с определённым типом. |
| page required | integer <int32> Страница, с которой следует выводить список. Минимальное значение — 1. |
| page_size required | integer <int32> Количество объектов на странице. Значение — от 1 до 1000. |
object Список сертификатов. | |||||
| |||||
{- "offer_id": "string",
- "status": "string",
- "type": "string",
- "page": 1,
- "page_size": 50
}{- "result": {
- "certificates": [
- {
- "certificate_id": 0,
- "certificate_number": "string",
- "certificate_name": "string",
- "type_code": "string",
- "status_code": "string",
- "accordance_type_code": "string",
- "rejection_reason_code": "string",
- "verification_comment": "string",
- "issue_date": "2019-08-24T14:15:22Z",
- "expire_date": "2019-08-24T14:15:22Z",
- "products_count": 0
}
], - "page_count": 0
}
}Метод для получения списка возможных статусов товаров при их привязке к сертификату.
Array of objects Список статусов товаров. | |||||
Array ()
| |||||
{ }{- "result": [
- {
- "code": "string",
- "name": "string"
}
]
}| certificate_id required | integer <int32> Идентификатор сертификата. |
| product_status_code | string Статус проверки товара при привязке к сертификату. |
| page required | integer <int32> Номер страницы, с которой выводить список. Минимальное значение — 1. |
| page_size required | integer <int32> Количество объектов на странице. Значение — от 1 до 1000. |
object Товары, привязанные к сертификату. | |||||
| |||||
{- "certificate_id": 0,
- "product_status_code": "string",
- "page": 1,
- "page_size": 50
}{- "result": {
- "items": [
- {
- "product_id": 0,
- "product_status_code": "string"
}
], - "count": 0
}
}| certificate_id required | integer <int32> Идентификатор сертификата. |
| product_id required | Array of strings <int64> Список идентификаторов товара, которые нужно отвязать от сертификата. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "certificate_id": 0,
- "product_id": [
- "string"
]
}{- "result": [
- {
- "error": "string",
- "product_id": 0,
- "updated": true
}
]
}Array of objects Причины отклонения сертификата. | |||||
Array ()
| |||||
{ }{- "result": [
- {
- "code": "string",
- "name": "string"
}
]
}Array of objects Список возможных статусов сертификатов. | |||||
Array ()
| |||||
{ }{- "result": [
- {
- "code": "string",
- "name": "string"
}
]
}Возвращает список складов FBS и rFBS. Чтобы получить список складов FBO, используйте метод /v1/cluster/list.
Метод можно использовать 1 раз в минуту.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | integer <int64> <= 200 Количество значений в ответе. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Список складов. | |||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||
{- "limit": 0,
- "offset": 0
}{- "result": [
- {
- "has_entrusted_acceptance": true,
- "is_rfbs": true,
- "name": "string",
- "warehouse_id": 0,
- "can_print_act_in_advance": true,
- "first_mile_type": {
- "dropoff_point_id": "string",
- "dropoff_timeslot_id": 0,
- "first_mile_is_changing": true,
- "first_mile_type": "DropOff"
}, - "has_postings_limit": true,
- "is_karantin": true,
- "is_kgt": true,
- "is_economy": true,
- "is_timetable_editable": true,
- "min_postings_limit": 0,
- "postings_limit": 0,
- "min_working_days": 0,
- "status": "string",
- "working_days": [
- "1"
]
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр для поиска методов доставки. | |
| limit required | integer <int64> Количество элементов в ответе. Максимум — 50, минимум — 1. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| has_next | boolean Признак, что в запросе вернулась только часть методов доставки:
| ||||||||||||||||||||||
Array of objects Результат запроса. | |||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||
{- "filter": {
- "provider_id": 424,
- "status": "ACTIVE",
- "warehouse_id": 15588127982000
}, - "limit": 100,
- "offset": 0
}{- "result": [
- {
- "id": 15588127982000,
- "company_id": 1,
- "name": "Ozon Логистика курьеру, Есипово",
- "status": "ACTIVE",
- "cutoff": "13:00",
- "provider_id": 24,
- "template_id": 0,
- "warehouse_id": 15588127982000,
- "created_at": "2019-04-04T15:22:31.048202Z",
- "updated_at": "2021-08-15T10:21:44.854209Z",
- "sla_cut_in": 1440
}
], - "has_next": false
}Возвращает список необработанных отправлений за указанный период времени — он должен быть не больше одного года.
Возможные статусы отправлений:
awaiting_registration — ожидает регистрации,acceptance_in_progress — идёт приёмка,awaiting_approve — ожидает подтверждения,awaiting_packaging — ожидает упаковки,awaiting_deliver — ожидает отгрузки,arbitration — арбитраж,client_arbitration — клиентский арбитраж доставки,delivering — доставляется,driver_pickup — у водителя,cancelled — отменено,not_accepted — не принят на сортировочном центре.Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| dir | string Направление сортировки:
|
required | object Фильтр запроса. Используйте фильтр либо по времени сборки — Чтобы использовать фильтр по времени сборки, заполните поля Чтобы использовать фильтр по дате передачи отправления в доставку, заполните поля |
| limit required | integer <int64> Количество значений в ответе:
|
| offset required | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
object Дополнительные поля, которые нужно добавить в ответ. |
object Результат запроса. | |||||
| |||||
{- "dir": "ASC",
- "filter": {
- "cutoff_from": "2021-08-24T14:15:22Z",
- "cutoff_to": "2021-08-31T14:15:22Z",
- "delivery_method_id": [ ],
- "is_quantum": false,
- "provider_id": [ ],
- "status": "awaiting_packaging",
- "warehouse_id": [ ]
}, - "limit": 100,
- "offset": 0,
- "with": {
- "analytics_data": true,
- "barcodes": true,
- "financial_data": true,
- "legal_info": false,
- "translit": true
}
}{- "result": {
- "postings": [
- {
- "posting_number": "23713478-0018-3",
- "order_id": 559293114,
- "order_number": "33713378-0051",
- "pickup_code_verified_at": "2025-01-17T11:03:00.124Z",
- "status": "awaiting_packaging",
- "delivery_method": {
- "id": 15110442724000,
- "name": "Ozon Логистика курьеру, Москва",
- "warehouse_id": 15110442724000,
- "warehouse": "Склад на Ленина",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2021-08-25T10:48:38Z",
- "shipment_date": "2021-08-26T10:00:00Z",
- "shipment_date_without_delay": "2021-08-26T10:00:00Z",
- "delivering_date": null,
- "optional": {
- "products_with_possible_mandatory_mark": [
- 0
]
}, - "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "quantum_id": 0,
- "products": [
- {
- "price": "1259",
- "currency_code": "RUB",
- "is_blr_traceable": true,
- "is_marketplace_buyout": true,
- "offer_id": "УТ-0001365",
- "name": "Мяч, цвет: черный, 5 кг",
- "sku": 140048123,
- "quantity": 1,
- "products_requiring_jw_uin": "0",
- "imei": [ ]
}
], - "addressee": null,
- "barcodes": {
- "upper_barcode": "%101%806044518",
- "lower_barcode": "23024930500000"
}, - "analytics_data": {
- "region": "Санкт-Петербург",
- "city": "Санкт-Петербург",
- "delivery_type": "PVZ",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 15110442724000,
- "warehouse": "Склад на Ленина",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика",
- "delivery_date_begin": "2022-08-28T14:00:00Z",
- "delivery_date_end": "2022-08-28T18:00:00Z",
- "is_legal": false,
- "client_delivery_date_begin": "2025-11-24T13:32:40.336Z",
- "client_delivery_date_end": "2025-11-24T13:32:40.336Z"
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 0,
- "commission_percent": 0,
- "payout": 0,
- "product_id": 140048123,
- "old_price": 1888,
- "price": 1259,
- "total_discount_value": 629,
- "total_discount_percent": 33.32,
- "actions": [
- "Системная виртуальная скидка селлера"
], - "quantity": 1
}
]
}, - "is_express": false,
- "legal_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}, - "require_blr_traceable_attrs": true,
- "requirements": {
- "products_requiring_change_country": [ ],
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ],
- "products_requiring_jwn": [ ],
- "products_requiring_imei": [ ]
}, - "tariffication": [
- {
- "current_tariff_rate": 0,
- "current_tariff_type": "",
- "current_tariff_charge": "",
- "current_tariff_charge_currency_code": "",
- "next_tariff_rate": 0,
- "next_tariff_type": "",
- "next_tariff_charge": "",
- "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
- "next_tariff_charge_currency_code": ""
}
]
}
], - "count": 55
}
}Возвращает список отправлений за указанный период времени — он должен быть не больше одного года.
Дополнительно можно отфильтровать отправления по их статусу — список доступных для выдачи статусов указан в описании параметра filter.status.
has_next = true в ответе может значить, что вернули не весь массив отправлений. Чтобы получить информацию об остальных отправлениях, сделайте новый запрос с другим значением offset.
Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| dir | string Направление сортировки:
|
required | object Фильтр. |
| limit required | integer <int64> Количество значений в ответе:
|
| offset required | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
object Дополнительные поля, которые нужно добавить в ответ. |
object Массив отправлений. | |||||
| |||||
{- "dir": "ASC",
- "filter": {
- "delivery_method_id": [
- "21321684811000"
], - "is_blr_traceable": true,
- "is_quantum": false,
- "last_changed_status_date": {
- "from": "2023-11-03T11:47:39.878Z",
- "to": "2023-11-03T11:47:39.878Z"
}, - "order_id": 0,
- "provider_id": [
- "24"
], - "since": "2023-11-03T11:47:39.878Z",
- "status": "awaiting_packaging",
- "to": "2023-11-03T11:47:39.878Z",
- "warehouse_id": [
- "21321684811000"
]
}, - "limit": 100,
- "offset": 0,
- "with": {
- "analytics_data": true,
- "barcodes": true,
- "financial_data": true,
- "translit": true
}
}{- "result": {
- "postings": [
- {
- "posting_number": "05708065-0029-1",
- "order_id": 680420041,
- "order_number": "05708065-0029",
- "pickup_code_verified_at": "2025-01-17T10:59:26.614Z",
- "status": "awaiting_deliver",
- "substatus": "posting_awaiting_passport_data",
- "delivery_method": {
- "id": 21321684811000,
- "name": "Ozon Логистика самостоятельно, Красногорск",
- "warehouse_id": 21321684811000,
- "warehouse": "Стим Тойс Нахабино",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2022-05-13T07:07:32Z",
- "shipment_date": "2022-05-13T10:00:00Z",
- "shipment_date_without_delay": "2022-05-13T10:00:00Z",
- "delivering_date": null,
- "optional": {
- "products_with_possible_mandatory_mark": [
- 0
]
}, - "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "products": [
- {
- "price": "1390.000000",
- "currency_code": "RUB",
- "is_blr_traceable": true,
- "is_marketplace_buyout": true,
- "offer_id": "205953",
- "name": " Электронный конструктор PinLab Позитроник",
- "sku": 358924380,
- "quantity": 1,
- "imei": [ ]
}
], - "addressee": null,
- "barcodes": null,
- "analytics_data": null,
- "financial_data": null,
- "is_express": false,
- "legal_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}, - "quantum_id": 0,
- "require_blr_traceable_attrs": true,
- "requirements": {
- "products_requiring_change_country": [ ],
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ],
- "products_requiring_mandatory_mark": [ ],
- "products_requiring_jwn": [ ],
- "products_requiring_imei": [ ]
}, - "tariffication": [
- {
- "current_tariff_rate": 0,
- "current_tariff_type": "",
- "current_tariff_charge": "",
- "current_tariff_charge_currency_code": "",
- "next_tariff_rate": 0,
- "next_tariff_type": "",
- "next_tariff_charge": "",
- "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
- "next_tariff_charge_currency_code": ""
}
]
}
], - "has_next": true
}
}Чтобы получать актуальную дату отгрузки, регулярно обновляйте информацию об отправлениях или подключите пуш-уведомления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Идентификатор отправления. |
object Дополнительные поля, которые нужно добавить в ответ. |
object Информация об отправлении. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "posting_number": "57195475-0050-3",
- "with": {
- "analytics_data": false,
- "barcodes": false,
- "financial_data": false,
- "legal_info": false,
- "product_exemplars": false,
- "related_postings": true,
- "translit": false
}
}{- "result": {
- "posting_number": "57195475-0050-3",
- "order_id": 438764970,
- "order_number": "57195475-0050",
- "pickup_code_verified_at": "2025-01-17T11:04:59.958Z",
- "status": "awaiting_packaging",
- "substatus": "posting_awaiting_passport_data",
- "previous_substatus": "posting_transferring_to_delivery",
- "delivery_method": {
- "id": 18114520187000,
- "name": "Ozon Логистика самостоятельно, Москва",
- "warehouse_id": 18114520187000,
- "warehouse": "Москва основной",
- "tpl_provider_id": 24,
- "tpl_provider": "Ozon Логистика"
}, - "tracking_number": "",
- "tpl_integration_type": "ozon",
- "in_process_at": "2021-11-20T09:14:16Z",
- "shipment_date": "2021-11-23T10:00:00Z",
- "shipment_date_without_delay": "2021-11-23T10:00:00Z",
- "delivering_date": null,
- "provider_status": "",
- "delivery_price": "",
- "optional": {
- "products_with_possible_mandatory_mark": [
- 0
]
}, - "cancellation": {
- "cancel_reason_id": 0,
- "cancel_reason": "",
- "cancellation_type": "",
- "cancelled_after_ship": false,
- "affect_cancellation_rating": false,
- "cancellation_initiator": ""
}, - "customer": null,
- "addressee": null,
- "products": [
- {
- "currency_code": "RUB",
- "is_blr_traceable": true,
- "is_marketplace_buyout": true,
- "price": "279.0000",
- "offer_id": "250-7898-1",
- "name": "Кофе ароматизированный \"Шоколадный апельсин\" 250 гр",
- "sku": 180550365,
- "quantity": 1,
- "jw_uin": [ ],
- "dimensions": {
- "height": "40.00",
- "length": "240.00",
- "weight": "260",
- "width": "140.00"
}, - "has_imei": false
}
], - "barcodes": null,
- "analytics_data": null,
- "financial_data": null,
- "additional_data": [ ],
- "is_express": false,
- "legal_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}, - "related_postings": {
- "related_posting_numbers": [
- "string"
]
}, - "require_blr_traceable_attrs": true,
- "requirements": {
- "products_requiring_change_country": [ ],
- "products_requiring_gtd": [ ],
- "products_requiring_country": [ ],
- "products_requiring_jwn": [ ],
- "products_requiring_imei": [ ]
}, - "product_exemplars": null,
- "tariffication": [
- {
- "current_tariff_rate": 0,
- "current_tariff_type": "",
- "current_tariff_charge": "",
- "current_tariff_charge_currency_code": "",
- "next_tariff_rate": 0,
- "next_tariff_type": "",
- "next_tariff_charge": "",
- "next_tariff_starts_at": "2023-11-13T08:05:57.657Z",
- "next_tariff_charge_currency_code": ""
}
]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| barcode | string Штрихкод отправления. Можно получить с помощью методов: /v3/posting/fbs/get, /v3/posting/fbs/list и /v3/posting/fbs/unfulfilled/list в массиве |
object Результаты запроса. | |||||||||||||||||||||
| |||||||||||||||||||||
{- "barcode": "20325804886000"
}{- "result": {
- "order_id": 47558522075,
- "order_number": "2130415463-0013",
- "posting_number": "2130415463-0013-1",
- "status": "delivered",
- "cancel_reason_id": 0,
- "created_at": "2025-01-29T08:58:07Z",
- "in_process_at": "2025-01-29T08:59:40Z",
- "shipment_date": "2025-01-29T18:00:00Z",
- "products": [
- {
- "sku": 498274975,
- "name": "Стульчик для кормления ребенка",
- "quantity": 1,
- "offer_id": "6460551001",
- "price": "2300.0000"
}
], - "barcodes": {
- "upper_barcode": "%101%10293145035",
- "lower_barcode": "201864523528000"
}
}
}Метод для передачи количества коробок для отправлений, в которых есть многокоробочные товары.
Используйте метод при работе по схеме rFBS Агрегатор — c доставкой партнёрами Ozon.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Идентификатор многокоробочного отправления. |
| multi_box_qty required | integer <int64> Количество коробок, в которые упакован товар. |
object Результат передачи количества коробок. | |||
| |||
{- "posting_number": "string",
- "multi_box_qty": 0
}{- "result": {
- "result": true
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Информация о товарах. |
| posting_number required | string Идентификатор отправления. |
| result | string Идентификатор отправления. |
{- "items": [
- {
- "sku": 1231428352,
- "weightReal": [
- 0.3
]
}
], - "posting_number": "33920158-0006-1"
}{- "result": "33920158-0006-1"
}Метод для получения списка доступных стран-изготовителей и их ISO кодов.
| name_search | string Фильтрация по строке. |
Array of objects Список стран-изготовителей и ISO коды. | |||||
Array ()
| |||||
{- "name_search": ""
}{- "result": [
- {
- "name": "Алжир",
- "country_iso_code": "DZ"
}, - {
- "name": "Ангилья",
- "country_iso_code": "AI"
}, - {
- "name": "Виргинские Острова (Великобритания)",
- "country_iso_code": "VG"
}
]
}Метод для добавления на продукт атрибута «Страна-изготовитель», если он не был указан.
| posting_number required | string Номер отправления. |
| product_id required | integer <int64> Идентификатор товара в системе продавца — |
| country_iso_code required | string Двухбуквенный код добавляемой страны по стандарту ISO_3166-1. Список доступных стран-изготовителей и их ISO коды можно получить с помощью метода /v2/posting/fbs/product/country/list. |
| product_id | integer <int64> Идентификатор товара в системе продавца — |
| is_gtd_needed | boolean Признак того, что необходимо передать номер грузовой таможенной декларации (ГТД) для продукта и отправления. |
{- "country_iso_code": "NO",
- "posting_number": "57195475-0050-3",
- "product_id": 180550365
}{- "product_id": 180550365,
- "is_gtd_needed": true
}Метод для получения габаритных, весовых и прочих ограничений пункта приёма по номеру отправления. Метод применим только для работы по схеме FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления, для которого нужно определить ограничения. |
object | |||||||||||||||||
| |||||||||||||||||
{- "posting_number": "76673629-0020-1"
}{- "result": {
- "posting_number": "76673629-0020-1",
- "max_posting_weight": 40000,
- "min_posting_weight": 0,
- "width": 500,
- "height": 500,
- "length": 500,
- "max_posting_price": 500000,
- "min_posting_price": 0
}
}Генерирует PDF-файл с этикетками для указанных отправлений в статусе «Ожидает отгрузки» — awaiting_deliver. В одном запросе можно передать не больше 20 идентификаторов. Если хотя бы для одного отправления возникнет ошибка, этикетки не будут подготовлены для всех отправлений в запросе.
Рекомендуем запрашивать этикетки через 45–60 секунд после сборки заказа.
Ошибка The next postings aren't ready означает, что этикетки ещё не готовы, повторите запрос позднее.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Идентификатор отправления. |
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "posting_number": [
- "48173252-0034-4"
]
}{ "content_type": "application/pdf", "file_name": "ticket-170660-2023-07-13T13:17:06Z.pdf", "file_content": "%PDF-1.7\n%âãÏÓ\n53 0 obj\n<</MarkInfo<</Marked true/Type/MarkInfo>>/Pages 9 0 R/StructTreeRoot 10 0 R/Type/Catalog>>\nendobj\n8 0 obj\n<</Filter/FlateDecode/Length 2888>>\nstream\nxå[[ݶ\u0011~?¿BÏ\u0005Bs\u001c^\u0000Àwí5ú\u0010 m\u0016Èsà¦)\n;hÒ\u0014èÏïG\u0014)<{äµ] ]?¬¬oIÎ}¤F±óϤñï\u001bÕü×X´OÏï?^~¹$<ø¨È9q\u0013Y\u0012åñì§_¼|ÿégü\t+\u0012\u001bxª}Æxҿ¿¼_º¼xg¦þ5OkuÌ3ýíògüûå\"Ni\u0016C\u0001°\u000fA9g'r¢\"\u0013YóĪ\u0018NÑ{\u001dÕóZ¬\\Ô\"" }
Метод для создания задания на асинхронное формирование этикеток для отправлений в статусе «Ожидает отгрузки» — awaiting_deliver.
Метод может вернуть несколько заданий: на формирование маленькой и большой этикетки.
Чтобы получить созданные этикетки, используйте /v1/posting/fbs/package-label/get.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Номера отправлений, для которых нужны этикетки. |
object Результат работы метода. | |||
| |||
{- "posting_number": [
- "4708216109137",
- "3697105098026"
]
}{- "result": {
- "tasks": [
- {
- "task_id": 5819327210248,
- "task_type": "big_label"
}, - {
- "task_id": 5819327210249,
- "task_type": "small_label"
}
]
}
}Метод для создания задания на асинхронное формирование этикеток.
Для получения этикеток, созданных в результате вызова метода, используйте /v1/posting/fbs/package-label/get.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Номера отправлений, для которых нужны этикетки. |
object Результат работы метода. | |||
| |||
{- "posting_number": [
- "string"
]
}{- "result": {
- "task_id": 5819327210249
}
}Метод для получения этикеток после вызова /v1/posting/fbs/package-label/create.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| task_id required | integer <int64> Номер задания на формирование этикеток из ответа метода /v1/posting/fbs/package-label/create. |
object Результат работы метода. | |||||||||||||
| |||||||||||||
{- "task_id": 0
}{- "result": {
- "error": "",
- "status": "completed",
- "printed_postings_count": 1,
- "unprinted_postings_count": 0,
- "unprinted_postings": [ ]
}
}Возвращает список причин отмены для конкретных отправлений.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| related_posting_numbers required | Array of strings Номера отправлений. |
Array of objects Результат запроса. | |||||
Array ()
| |||||
{- "related_posting_numbers": [
- "73837363-0010-3"
]
}{- "result": [
- {
- "posting_number": "73837363-0010-3",
- "reasons": [
- {
- "id": 352,
- "title": "Товар закончился на складе продавца",
- "type_id": "seller"
}, - {
- "id": 400,
- "title": "Остался только бракованный товар",
- "type_id": "seller"
}, - {
- "id": 402,
- "title": "Другое (вина продавца)",
- "type_id": "seller"
}
]
}
]
}Возвращает список причин отмены для всех отправлений.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Результат работы метода. | |||||||||
Array ()
| |||||||||
{- "result": [
- {
- "id": 352,
- "title": "Товар закончился на складе продавца",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 401,
- "title": "Продавец отклонил арбитраж",
- "type_id": "seller",
- "is_available_for_cancellation": false
}, - {
- "id": 402,
- "title": "Другое (вина продавца)",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 666,
- "title": "Возврат из службы доставки: нет доставки в указанный регион",
- "type_id": "seller",
- "is_available_for_cancellation": false
}
]
}Используйте метод, если вы не можете отправить часть продуктов из отправления.
Чтобы получить идентификаторы причин отмены cancel_reason_id при работе по схемам FBS или rFBS, используйте метод /v2/posting/fbs/cancel-reason/list.
Условно-доставленные отправления отменить нельзя.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancel_reason_id required | integer <int64> Идентификатор причины отмены отправления товара. |
| cancel_reason_message required | string Обязательное поле. Дополнительная информация по отмене. |
required | Array of objects Информация о товарах. |
| posting_number required | string Идентификатор отправления. |
| result | string Номер отправления. |
{- "cancel_reason_id": 352,
- "cancel_reason_message": "Product is out of stock",
- "items": [
- {
- "quantity": 5,
- "sku": 150587396
}
], - "posting_number": "33920113-1231-1"
}{- "result": ""
}Меняет статус отправления на cancelled.
Перед началом работы проверьте причины отмены для конкретного отправления методом /v1/posting/fbs/cancel-reason.
Условно-доставленные отправления отменить нельзя.
Если значение параметра cancel_reason_id — 402, заполните поле cancel_reason_message.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cancel_reason_id | integer <int64> Идентификатор причины отмены отправления. |
| cancel_reason_message | string Дополнительная информация по отмене. Если |
| posting_number | string Идентификатор отправления. |
| result | boolean Результат обработки запроса. |
{- "cancel_reason_id": 352,
- "cancel_reason_message": "Product is out of stock",
- "posting_number": "33920113-1231-1"
}{- "result": true
}Если отправление передано в доставку, но не просканировано в сортировочном центре, можно открыть спор. Открытый спор переведёт отправление в статус arbitration.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Идентификатор отправления. |
| result | boolean Результат обработки запроса. |
{- "posting_number": [
- "33920143-1195-1"
]
}{- "result": true
}Передает спорные заказы к отгрузке. Статус отправления изменится на awaiting_deliver.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Идентификатор отправления. Максимальное количество в одном запросе — 100. |
| result | boolean Результат обработки запроса. |
{- "posting_number": [
- "33920143-1195-1"
]
}{- "result": true
}Метод позволяет проверить код курьера при передаче отправлений realFBS Express. Подробнее о передаче отправлений в Базе знаний продавца.
| pickup_code required | string Код курьера. |
| posting_number required | string Номер отправления. |
| valid | boolean
|
{- "pickup_code": "string",
- "posting_number": "string"
}{- "valid": true
}Метод для получения таможенных деклараций Elektronik Ticaret Gümrük Beyannamesi (ETGB) для продавцов из Турции.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Фильтр по периоду создания деклараций. |
Array of objects Результат запроса. | |||||
Array ()
| |||||
{- "date": {
- "from": "2023-02-13T12:13:16.818Z",
- "to": "2023-02-13T12:13:16.818Z"
}
}{- "result": [
- {
- "posting_number": "string",
- "etgb": {
- "number": "string",
- "date": "string",
- "url": "string"
}
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений в ответе. |
Array of objects Список неоплаченных товаров. | |
| cursor | string Указатель для выборки следующих данных. |
{- "cursor": "",
- "limit": 1000
}{- "products": [
- {
- "product_id": 145123054,
- "offer_id": "10032",
- "quantity": 1,
- "name": "Телевизор LG",
}
], - "cursor": "hCGiPPopcBFMgMErdzaCEpzQfinuPyEhUoSmBMADuoFAhBjXeA=="
}Вы можете добавить полигон к методу доставки.
Создайте полигон, получив его координаты на https://geojson.io: отметьте на карте минимум 3 точки и соедините их линиями.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| coordinates required | string Координаты полигона доставки в формате |
| polygon_id | integer <int64> Идентификатор полигона. |
{- "coordinates": "[[[30.149574279785153,59.86550435303646],[30.21205902099609,59.846884387977326],[30.255661010742184,59.86240174913176],[30.149574279785153,59.86550435303646]]]"
}{- "polygonId": "1323"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id required | integer <int32> Идентификатор метода доставки. |
required | Array of objects Список полигонов. |
required | object Расположение склада. |
{- "delivery_method_id": 0,
- "polygons": [
- {
- "polygon_id": "1323",
- "time": "30"
}
], - "warehouse_location": {
- "lat": "58.52391272075821",
- "lon": "31.236791610717773"
}
}{ }Возвращает список отправлений за указанный период времени.
Если период больше года, вернётся ошибка PERIOD_IS_TOO_LONG.
Дополнительно можно отфильтровать отправления по их статусу.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| dir | string Направление сортировки:
|
required | object Фильтр для поиска отправлений. |
| limit required | integer <int64> Количество значений в ответе:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| translit | boolean Если включена транслитерация адреса из кириллицы в латиницу — |
object Дополнительные поля, которые нужно добавить в ответ. |
Array of objects Массив отправлений. | |||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||
{- "dir": "ASC",
- "filter": {
- "since": "2021-09-01T00:00:00.000Z",
- "status": "",
- "to": "2021-11-17T10:44:12.828Z"
}, - "limit": 5,
- "offset": 0,
- "translit": true,
- "with": {
- "analytics_data": true,
- "financial_data": true,
- "legal_info": false
}
}{- "result": [
- {
- "order_id": 354680487,
- "order_number": "16965409-0014",
- "posting_number": "16965409-0014-1",
- "status": "delivered",
- "substatus": "posting_delivered",
- "cancel_reason_id": 0,
- "created_at": "2021-09-01T00:23:45.607000Z",
- "in_process_at": "2021-09-01T00:25:30.120000Z",
- "legal_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}, - "products": [
- {
- "sku": 160249683,
- "name": "Так говорил Омар Хайям. Жизнеописание. Афоризмы и рубайят. Классика в словах и картинках",
- "quantity": 1,
- "offer_id": "978-5-906864-56-7",
- "price": "81.00",
- "is_marketplace_buyout": true,
- "digital_codes": [ ],
- "currency_code": "RUB"
}
], - "analytics_data": {
- "city": "",
- "delivery_type": "PVZ",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 17717042026000,
- "warehouse_name": "РОСТОВ-НА-ДОНУ_РФЦ",
- "is_legal": false,
- "client_delivery_date_begin": "2025-11-24T13:32:40.336Z",
- "client_delivery_date_end": "2025-11-24T13:32:40.336Z"
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 12.15,
- "commission_percent": 15,
- "payout": 68.85,
- "product_id": 160249683,
- "currency_code": "RUB",
- "old_price": 115,
- "price": 81,
- "total_discount_value": 34,
- "total_discount_percent": 29.57,
- "actions": [
- "Системная виртуальная скидка селлера"
], - "quantity": 0
}
]
}, - "additional_data": [ ]
}
]
}Возвращает информацию об отправлении по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
| translit | boolean Если включена транслитерация адреса из кириллицы в латиницу — |
object Дополнительные поля, которые нужно добавить в ответ. |
object Результат запроса. | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
{- "posting_number": "50520644-0012-7",
- "translit": true,
- "with": {
- "analytics_data": true,
- "financial_data": true,
- "legal_info": false
}
}{- "result": {
- "order_id": 354679434,
- "order_number": "50520644-0012",
- "posting_number": "50520644-0012-7",
- "status": "delivered",
- "substatus": "posting_delivered",
- "cancel_reason_id": 0,
- "created_at": "2021-09-01T00:34:56.563Z",
- "in_process_at": "2021-09-01T00:34:56.103Z",
- "legal_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}, - "products": [
- {
- "sku": 254665483,
- "name": "Мочалка натуральная из люфы с деревянной ручкой",
- "quantity": 1,
- "offer_id": "PS1033",
- "price": "137.00",
- "is_marketplace_buyout": true,
- "digital_codes": [ ],
- "currency_code": "RUB"
}
], - "analytics_data": {
- "city": "",
- "delivery_type": "Courier",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 15431806189000,
- "warehouse_name": "ХОРУГВИНО_РФЦ",
- "is_legal": false,
- "client_delivery_date_begin": "2025-11-24T13:32:40.336Z",
- "client_delivery_date_end": "2025-11-24T13:32:40.336Z"
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 13.7,
- "commission_percent": 10,
- "payout": 123.3,
- "product_id": 254665483,
- "currency_code": "RUB",
- "old_price": 198,
- "price": 137,
- "total_discount_value": 61,
- "total_discount_percent": 30.81,
- "actions": [
- "Системная виртуальная скидка селлера"
], - "quantity": 0
}
]
}, - "additional_data": [ ]
}
}Возвращает список причин отмены для всех FBO-отправлений.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о причинах отмены. | |||||
Array ()
| |||||
{- "result": [
- {
- "id": 352,
- "title": "Товар закончился на складе продавца",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 401,
- "title": "Продавец отклонил арбитраж",
- "type_id": "seller",
- "is_available_for_cancellation": false
}, - {
- "id": 402,
- "title": "Другое (вина продавца)",
- "type_id": "seller",
- "is_available_for_cancellation": true
}, - {
- "id": 666,
- "title": "Возврат из службы доставки: нет доставки в указанный регион",
- "type_id": "seller",
- "is_available_for_cancellation": false
}
]
}Возвращает количество заявок в конкретном статусе.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects | |||||
Array ()
| |||||
{ }{- "items": [
- {
- "count": 0,
- "order_state": "ORDER_STATE_UNSPECIFIED"
}
]
}Используйте метод, чтобы получить товарный состав поставки или черновика заявки на поставку. Одним вызовом метода можно получить состав одной поставки или черновика заявки.
| bundle_ids required | Array of strings [ 1 .. 100 ] items Идентификаторы товарного состава поставки. Можно получить в методе /v2/supply-order/get. |
| is_asc | boolean
|
object Список складов для расчёта товарных тегов. | |
| last_id | string Идентификатор последнего значения SKU на странице. |
| limit required | integer <int32> [ 1 .. 100 ] Количество товаров на странице. |
| query | string Поисковый запрос, например: по названию, артикулу или SKU. |
| sort_field | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "SKU" "NAME" "QUANTITY" "TOTAL_VOLUME_IN_LITRES" Сортировка по параметрам:
|
Array of objects Список товаров в заявке на поставку. | |
| total_count | integer <int32> Количество товаров в заявке. |
| has_next | boolean Признак, что в ответе вернули не все товары:
|
| last_id | string Идентификатор последнего значения на странице. |
{- "bundle_ids": [
- "string"
], - "is_asc": true,
- "item_tags_calculation": {
- "dropoff_warehouse_id": 0,
- "storage_warehouse_ids": [
- "string"
]
}, - "last_id": "string",
- "limit": 100,
- "query": "string",
- "sort_field": "UNSPECIFIED"
}{- "items": [
- {
- "icon_path": "string",
- "sku": 0,
- "name": "string",
- "quantity": 0,
- "barcode": "string",
- "product_id": 0,
- "quant": 0,
- "is_quant_editable": true,
- "volume_in_litres": 0,
- "total_volume_in_litres": 0,
- "contractor_item_code": "string",
- "sfbo_attribute": "ITEM_SFBO_ATTRIBUTE_UNSPECIFIED",
- "shipment_type": "BUNDLE_ITEM_SHIPMENT_TYPE_UNSPECIFIED",
- "tags": [
- "EVSD_REQUIRED"
], - "placement_zone": "UNSPECIFIED"
}
], - "total_count": 0,
- "has_next": true,
- "last_id": "string"
}Учитываются заявки с поставкой на конкретный склад и через виртуальный распределительный центр (вРЦ).
required | object Фильтр. |
| last_id | string Идентификатор последнего значения на странице. При первом запросе оставьте это поле пустым. Чтобы получить следующие значения, укажите |
| limit required | integer <int32> [ 1 .. 100 ] Количество значений на странице. |
| sort_by required | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "ORDER_CREATION" "ORDER_STATE_UPDATED_AT" "TIMESLOT_FROM_UTC" "TIMESLOT_FROM_LOCAL" Параметр, по которому заявки на поставку будут отсортированы:
|
| sort_dir | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "ASC" "DESC" Направление сортировки:
|
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, укажите полученное значение в следующем запросе в параметре |
| order_ids | Array of strings <int64> Идентификаторы заявок на поставку. |
{- "filter": {
- "states": [
- "COMPLETED"
]
}, - "last_id": "null",
- "limit": 1,
- "sort_by": "ORDER_CREATION",
- "sort_dir": "DESC"
}{- "order_ids": [
- 0
], - "last_id": "string"
}Учитываются заявки с поставкой на конкретный склад и через виртуальный распределительный центр (вРЦ).
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
required | object Настройка отображения списка заявок. |
| last_supply_order_id | integer <int64> Идентификатор заявки на поставку, который вы запрашивали в прошлый раз. |
| supply_order_id | Array of strings <int64> Идентификатор заявки на поставку. |
{- "filter": {
- "states": [
- "ORDER_STATE_COMPLETED",
- "ORDER_STATE_DATA_FILLING"
]
}, - "paging": {
- "from_supply_order_id": 0,
- "limit": 100
}
}{- "last_supply_order_id": 0,
- "supply_order_id": [
- "string"
]
}Учитываются заявки с поставкой на конкретный склад и через виртуальный распределительный центр (вРЦ).
| order_ids required | Array of strings <int64> <= 50 items Идентификаторы заявок на поставку. |
Array of objects Список заявок на поставку. | |||||||||||||||||||||
Array ()
| |||||||||||||||||||||
{- "order_ids": [
- 123
]
}{- "orders": [
- {
- "order_id": 0,
- "order_number": "string",
- "created_date": "string",
- "state": "UNSPECIFIED",
- "state_updated_date": "string",
- "data_filling_deadline_utc": "string",
- "dropoff_warehouse": {
- "warehouse_id": 0,
- "address": "string",
- "name": "string"
}, - "order_tags": {
- "is_econom": true,
- "is_virtual": true,
- "original_supply_id": 0,
- "is_super_fbo": true,
- "product_super_fbo": true,
- "is_quant": true
}, - "timeslot": {
- "timeslot": {
- "from": "string",
- "to": "string"
}, - "timezone_info": {
- "offset": "string",
- "iana_name": "string"
}
}, - "supplies": [
- {
- "supply_id": 0,
- "storage_warehouse": {
- "warehouse_id": 0,
- "arrival_date": "string",
- "address": "string",
- "name": "string"
}, - "supply_tags": {
- "is_ettn_required": true,
- "is_evsd_required": true,
- "is_jewelry": true,
- "is_marking_possible": true,
- "is_marking_required": true,
- "is_utd": true,
- "freeze_stock_for_marking": true
}, - "is_crossdock": true,
- "bundle_id": "string",
- "state": "UNSPECIFIED"
}
]
}
]
}Учитываются заявки с поставкой на конкретный склад и через виртуальный распределительный центр (вРЦ).
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| order_ids required | Array of strings <int64> Идентификатор заявки на поставку в системе Ozon. |
Array of objects Информация о заявке на поставку. | |
Array of objects Информация о складе. |
{- "order_ids": [
- "string"
]
}{- "orders": [
- {
- "can_cancel": true,
- "creation_date": "string",
- "data_filling_deadline_utc": "2019-08-24T14:15:22Z",
- "dropoff_warehouse_id": 0,
- "is_econom": true,
- "is_super_fbo": true,
- "is_virtual": true,
- "product_super_fbo": true,
- "state": "ORDER_STATE_DATA_FILLING",
- "supplies": [
- {
- "bundle_id": "string",
- "storage_warehouse_id": 0,
- "supply_id": 0,
- "supply_state": "SUPPLY_STATE_UNSPECIFIED",
- "supply_tags": [
- {
- "is_ettn_required": true,
- "is_evsd_required": true,
- "is_jewelry": true,
- "is_marking_possible": true,
- "is_marking_required": true,
- "is_traceable": true
}
]
}
], - "supply_order_id": 0,
- "supply_order_number": "string",
- "timeslot": {
- "can_not_set_reasons": [
- "string"
], - "can_set": true,
- "is_required": true,
- "value": {
- "timeslot": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
], - "timezone_info": [
- {
- "iana_name": "string",
- "offset": "string"
}
]
}
}, - "vehicle": {
- "can_not_set_reasons": [
- "string"
], - "can_set": true,
- "is_required": true,
- "value": [
- {
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_model": "string",
- "vehicle_number": "string"
}
]
}
}
], - "warehouses": [
- {
- "address": "string",
- "name": "string",
- "warehouse_id": 0
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_order_id required | integer <int64> Идентификатор заявки на поставку. |
Array of objects Интервалы поставки. | |
Array of objects Часовой пояс. |
{- "supply_order_id": 0
}{- "timeslots": [
- {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
], - "timezone": [
- {
- "iana_name": "string",
- "offset": "string"
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_order_id required | integer <int64> Идентификатор заявки на поставку. |
required | object Время интервала поставки. |
| errors | Array of strings Items Enum: "UPDATE_TIMESLOT_ERROR_UNSPECIFIED" "UPDATE_TIMESLOT_ERROR_INVALID_ORDER_STATE" "UPDATE_TIMESLOT_ERROR_INCOMPATIBLE_ORDER_FLOW" "UPDATE_TIMESLOT_ERROR_SET_TIMESLOT_DEADLINE_EXCEED" "UPDATE_TIMESLOT_ERROR_OUT_OF_ALLOWED_RANGE" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_COMPANY" Возможные ошибки:
|
| operation_id | string Идентификатор операции. |
{- "supply_order_id": 0,
- "timeslot": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
}{- "errors": [
- "UPDATE_TIMESLOT_ERROR_UNSPECIFIED"
], - "operation_id": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
| errors | Array of strings Items Enum: "UPDATE_TIMESLOT_ERROR_UNSPECIFIED" "UPDATE_TIMESLOT_ERROR_INVALID_ORDER_STATE" "UPDATE_TIMESLOT_ERROR_INCOMPATIBLE_ORDER_FLOW" "UPDATE_TIMESLOT_ERROR_SET_TIMESLOT_DEADLINE_EXCEED" "UPDATE_TIMESLOT_ERROR_OUT_OF_ALLOWED_RANGE" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "UPDATE_TIMESLOT_ERROR_ORDER_NOT_BELONG_COMPANY" Возможные ошибки:
|
| status | string Default: "STATUS_UNSPECIFIED" Enum: "STATUS_UNSPECIFIED" "STATUS_ERROR" "STATUS_IN_PROGRESS" "STATUS_SUCCESS" Статус данных:
|
{- "operation_id": "string"
}{- "errors": [
- "UPDATE_TIMESLOT_ERROR_UNSPECIFIED"
], - "status": "STATUS_UNSPECIFIED"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_order_id required | integer <int64> Идентификатор заявки на поставку. |
required | object Информация о водителе и автомобиле. |
| error_reasons | Array of strings Items Enum: "SET_VEHICLE_ERROR_UNSPECIFIED" "SET_VEHICLE_ERROR_INVALID_ORDER_STATE" "SET_VEHICLE_ERROR_VEHICLE_NOT_REQUIRED" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_COMPANY" Причина ошибки:
|
| operation_id | string Идентификатор операции. |
{- "supply_order_id": 0,
- "vehicle": {
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_model": "string",
- "vehicle_number": "string"
}
}{- "error_reasons": [
- "SET_VEHICLE_ERROR_UNSPECIFIED"
], - "operation_id": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
| errors | Array of strings Items Enum: "SET_VEHICLE_ERROR_UNSPECIFIED" "SET_VEHICLE_ERROR_INVALID_ORDER_STATE" "SET_VEHICLE_ERROR_VEHICLE_NOT_REQUIRED" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_CONTRACTOR" "SET_VEHICLE_ERROR_ORDER_NOT_BELONG_COMPANY" Причина ошибки:
|
| result | string Default: "Unknown" Enum: "Unknown" "Success" "InProgress" "Failed" Статус ввода данных о водителе и автомобиле:
|
{- "operation_id": "string"
}{- "errors": [
- "SET_VEHICLE_ERROR_UNSPECIFIED"
], - "result": "Unknown"
}Метод возвращает список активных складов Ozon с информацией об их средней загруженности на ближайшее время.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Результат работы метода. | |||||
Array ()
| |||||
{- "result": [
- {
- "schedule": {
- "capacity": [
- {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z",
- "value": 0
}
], - "date": "2019-08-24T14:15:22Z"
}, - "warehouse": {
- "id": "string",
- "name": "string"
}
}
]
}| cluster_ids | Array of strings <int64> Идентификаторы кластеров. |
| cluster_type required | string Enum: "CLUSTER_TYPE_OZON" "CLUSTER_TYPE_CIS" Тип кластера:
|
Array of objects Кластеры. | |||||||||||
Array ()
| |||||||||||
{- "cluster_type": "CLUSTER_TYPE_OZON"
}{- "clusters": [
- {
- "id": 0,
- "logistic_clusters": [
- {
- "warehouses": [
- {
- "name": "string",
- "type": "FULL_FILLMENT",
- "warehouse_id": 0
}
]
}
], - "macrolocal_cluster_id": 0,
- "name": "string",
- "type": "CLUSTER_TYPE_OZON"
}
]
}Используйте метод, чтобы найти точки отгрузки для кросс-докинга и прямых поставок.
Вы можете посмотреть адреса всех точек на карте и в виде таблицы в Базе знаний.
| filter_by_supply_type required | Array of strings Items Enum: "CREATE_TYPE_CROSSDOCK" "CREATE_TYPE_DIRECT" Тип поставки:
|
| search required | string >= 4 characters Поиск по названию склада — |
Array of objects Результат поиска складов. | |||||||||||
Array ()
| |||||||||||
{- "filter_by_supply_type": [
- "CREATE_TYPE_CROSSDOCK"
], - "search": "string"
}{- "search": [
- {
- "address": "string",
- "coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "name": "string",
- "warehouse_id": 0,
- "warehouse_type": "WAREHOUSE_TYPE_DELIVERY_POINT"
}
]
}Создать черновик заявки на поставку — прямой или кросс-докинг, а также указать поставляемые товары.
| cluster_ids | Array of strings <int64> Идентификаторы кластеров для поставки. Получите методом /v1/cluster/list. |
| drop_off_point_warehouse_id | integer <int64> Идентификатор точки отгрузки — пункта выдачи заказов или сортировочного центра. Можно получить с помощью метода /v1/warehouse/fbo/list.
Только для типа поставки |
required | Array of objects <= 5000 items Товары. |
| type required | string Enum: "CREATE_TYPE_CROSSDOCK" "CREATE_TYPE_DIRECT" Тип поставки:
|
| operation_id | string Идентификатор черновика заявки на поставку. |
{- "cluster_ids": [
- "string"
], - "drop_off_point_warehouse_id": 0,
- "items": [
- {
- "quantity": 0,
- "sku": 0
}
], - "type": "CREATE_TYPE_CROSSDOCK"
}{- "operation_id": "string"
}Возвращает информацию о созданном черновике заявки на поставку. В ответе вернутся склады размещения в каждом выбранном кластере, которые примут все товары.
| operation_id required | string Уникальный идентификатор генерации черновика заявки на поставку. |
Array of objects Кластеры. | |
| draft_id | integer <int64> Идентификатор черновика заявки на поставку. |
Array of objects Ошибки. | |
| status | string Default: "CALCULATION_STATUS_FAILED" Enum: "CALCULATION_STATUS_FAILED" "CALCULATION_STATUS_SUCCESS" "CALCULATION_STATUS_IN_PROGRESS" "CALCULATION_STATUS_EXPIRED" Статус создания черновика заявки на поставку:
|
{- "operation_id": "0191c1c8-041c-754f-bba1-05de7741f9cb"
}{- "clusters": [
- {
- "cluster_id": 0,
- "cluster_name": "string",
- "warehouses": [
- {
- "bundle_ids": [
- {
- "bundle_id": "string",
- "is_docless": true
}
], - "restricted_bundle_id": "string",
- "status": {
- "invalid_reason": "WAREHOUSE_SCORING_INVALID_REASON_UNSPECIFIED",
- "is_available": true,
- "state": "WAREHOUSE_SCORING_STATUS_FULL_AVAILABLE"
}, - "supply_warehouse": {
- "address": "string",
- "name": "string",
- "warehouse_id": 0
}, - "total_rank": 0,
- "total_score": 0,
- "travel_time_days": 0
}
]
}
], - "draft_id": 30957724,
- "errors": [
- {
- "error_message": "string",
- "items_validation": [
- {
- "reasons": [
- "string"
], - "sku": 0
}
], - "unknown_cluster_ids": [
- "string"
]
}
], - "status": "CALCULATION_STATUS_FAILED"
}Возвращает доступные таймслоты на конечных складах отгрузки. Для кросс-док поставок вернутся таймслоты склада отгрузки, который был передан при создании черновика.
| date_from required | string <date-time> Дата начала нужного периода доступных таймслотов. |
| date_to required | string <date-time> Дата окончания нужного периода доступных таймслотов. Максимальный период — 28 дней с текущей даты. |
| draft_id required | integer <int64> Идентификатор черновика заявки на поставку. Получите методом /v1/draft/create/info. |
| warehouse_ids required | Array of strings <int64> <= 10 items Идентификаторы складов размещения. |
Array of objects Таймслоты складов. | |
| requested_date_from | string <date-time> Дата начала интересующего периода. |
| requested_date_to | string <date-time> Дата окончания интересующего периода. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "draft_id": 0,
- "warehouse_ids": [
- "string"
]
}{- "drop_off_warehouse_timeslots": [
- {
- "current_time_in_timezone": "2019-08-24T14:15:22Z",
- "days": [
- {
- "date_in_timezone": "2019-08-24T14:15:22Z",
- "timeslots": [
- {
- "from_in_timezone": "2019-08-24T14:15:22Z",
- "to_in_timezone": "2019-08-24T14:15:22Z"
}
]
}
], - "drop_off_warehouse_id": 0,
- "warehouse_timezone": "string"
}
], - "requested_date_from": "2019-08-24T14:15:22Z",
- "requested_date_to": "2019-08-24T14:15:22Z"
}| draft_id required | integer <int64> Идентификатор черновика заявки на поставку. |
object Таймслот поставки. | |
| warehouse_id required | integer <int64> Идентификатор склада размещения. Можно получить с помощью метода /v1/draft/create/info. |
| operation_id | string Идентификатор заявки на поставку. |
{- "draft_id": 0,
- "timeslot": {
- "from_in_timezone": "2019-08-24T14:15:22Z",
- "to_in_timezone": "2019-08-24T14:15:22Z"
}, - "warehouse_id": 0
}{- "operation_id": "string"
}| operation_id required | string Идентификатор заявки на поставку. |
| error_messages | Array of strings Ошибки создания заявок. | ||
object Идентификаторы заявок на поставку. | |||
| |||
| status | string Default: "DraftSupplyCreateStatusUnknown" Enum: "DraftSupplyCreateStatusUnknown" "DraftSupplyCreateStatusSuccess" "DraftSupplyCreateStatusFailed" "DraftSupplyCreateStatusInProgress" Статус создания заявки на поставку:
| ||
{- "operation_id": "string"
}{- "error_messages": [
- "string"
], - "result": {
- "order_ids": [
- "string"
]
}, - "status": "DraftSupplyCreateStatusUnknown"
}Используйте метод, чтобы передать грузоместа и товарный состав в заявку на поставку.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Информация о грузоместах. Вы можете передать не больше 40 палет или 30 коробок. |
| delete_current_version | boolean
|
| supply_id required | integer <int64> Идентификатор поставки. Можно получить с помощью метода /v2/supply-order/get. Нужное значение — в параметре ответа |
| operation_id | string Идентификатор операции. |
object Ошибки. |
{- "cargoes": [
- {
- "key": "string",
- "value": {
- "items": [
- {
- "barcode": "string",
- "expires_at": "2025-12-25T29:59:99Z",
- "offer_id": "string",
- "quant": 1,
- "quantity": 0
}
], - "type": "BOX"
}
}
], - "delete_current_version": true,
- "supply_id": 0
}{- "operation_id": "string",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
], - "items_validation": [
- {
- "barcode": "string",
- "cargo_key": "string",
- "quant": 0,
- "type": "SUPPLY_ITEM_NOT_FOUND"
}
]
}
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
object Ошибки. | |||
object Результат запроса. | |||
| |||
| status | string Default: "STATUS_UNSPECIFIED" Enum: "STATUS_UNSPECIFIED" "SUCCESS" "IN_PROGRESS" "FAILED" Статус формирования грузоместа:
| ||
{- "operation_id": "string"
}{- "errors": {
- "error_reasons": [
- "ERROR_REASON_UNSPECIFIED"
], - "items_validation": [
- {
- "cargo_key": "string",
- "item": "string",
- "quant": 0,
- "type": "SUPPLY_ITEM_NOT_FOUND"
}
]
}, - "result": {
- "cargoes": [
- {
- "key": "string",
- "value": {
- "cargo_id": 0
}
}
]
}, - "status": "STATUS_UNSPECIFIED"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
object Результат запроса. | |||
| |||
| status | string Default: "SUCCESS" Enum: "SUCCESS" "IN_PROGRESS" "FAILED" Статус формирования грузомест:
| ||
object Ошибки. | |||
{- "operation_id": "string"
}{- "result": {
- "cargoes": [
- {
- "key": "string",
- "value": {
- "cargo_id": 0
}
}
]
}, - "status": "SUCCESS",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
], - "items_validation": [
- {
- "barcode": "string",
- "cargo_key": "string",
- "quant": 0,
- "type": "SUPPLY_ITEM_NOT_FOUND"
}
]
}
}Метод для удаления грузомест в заявке на поставку.
Чтобы проверить статус удаления, используйте метод /v1/cargoes/delete/status.
| cargo_ids | Array of strings <int64> Список идентификаторов грузомест, которые нужно удалить. Максимум 70 значений. |
| supply_id | integer <int64> Идентификатор поставки. |
object Список ошибок, которые возникли при удалении грузомест. | |
| operation_id | string Идентификатор операции. |
{- "cargo_ids": [
- "string"
], - "supply_id": 0
}{- "errors": {
- "cargo_error_reasons": [
- {
- "cargo_id": 0,
- "error_reasons": [
- "CARGO_NOT_FOUND"
]
}
], - "supply_error_reasons": [
- "SUPPLY_NOT_FOUND"
]
}, - "operation_id": "string"
}Метод для получения статуса удаления грузомест в заявке на поставку.
| operation_id | string Идентификатор операции. |
object Список ошибок, которые возникли при удалении грузомест. | |
| status | string Enum: "SUCCESS" "IN_PROGRESS" "ERROR" Статус удаления грузоместа. Возможные статусы:
|
{- "operation_id": "string"
}{- "errors": {
- "cargo_error_reasons": [
- {
- "cargo_id": 0,
- "error_reasons": [
- "CARGO_NOT_FOUND"
]
}
], - "supply_error_reasons": [
- "SUPPLY_NOT_FOUND"
]
}, - "status": "SUCCESS"
}Метод для получения чек-листа с правилами по установке грузомест.
| supply_ids | Array of strings <int64> Список идентификаторов поставок в заявке. Максимум 100 идентификаторов. |
Array of objects Список чек-листов с правилами заполнения грузомест по поставкам. | |||||||||||||||
Array ()
| |||||||||||||||
{- "supply_ids": [
- "string"
]
}{- "supply_check_lists": [
- {
- "cargoes_presents_rule": {
- "cargo_count_per_type": [
- {
- "count": 0,
- "type": "BOX"
}
], - "count": 0,
- "satisfied": true
}, - "edit_deadline_expire_rule": {
- "is_applicable": true,
- "is_required": true,
- "satisfied": true
}, - "expire_dates_presented_rule": {
- "count_sku_with_expiration": 0,
- "count_sku_with_expiration_filled": 0,
- "is_applicable": true,
- "is_required": true,
- "satisfied": true
}, - "is_valid_distribution_rule": {
- "count_distributed_sku": 0,
- "count_sku_total": 0,
- "is_applicable": true,
- "percents_int": 0,
- "satisfied": true
}, - "package_units_with_distribution_rule": {
- "count_all": 0,
- "count_with_distribution": 0,
- "is_applicable": true,
- "is_required": true,
- "satisfied": true
}, - "placement_zones_rule": {
- "count_cargoes_all": 0,
- "count_cargoes_with_mono_placement_zone": 0,
- "is_applicable": true,
- "satisfied": true
}, - "supply_id": 0
}
]
}Используйте метод, чтобы сгенерировать этикетки для грузомест из заявки на поставку.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о грузоместах. | |
| supply_id required | integer <int64> Идентификатор поставки. |
| operation_id | string Идентификатор операции. |
object Ошибки. |
{- "cargoes": [
- {
- "cargo_id": 0
}
], - "supply_id": 0
}{- "operation_id": "string",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
]
}
}Используйте метод, чтобы получить статус формирования этикеток и идентификатор файла с ними.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
object Информация об этикетках. | |||
| |||
| status | string Default: "SUCCESS" Enum: "SUCCESS" "IN_PROGRESS" "FAILED" Статус формирования этикеток:
| ||
object Ошибки. | |||
{- "operation_id": "string"
}{- "result": {
- "file_guid": "string"
}, - "status": "SUCCESS",
- "errors": {
- "error_reasons": [
- "INVALID_STATE"
]
}
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| order_id required | integer <int64> Идентификатор заявки на поставку. |
| operation_id | string Идентификатор операции на отмену заявки. |
{- "order_id": 0
}{- "operation_id": "string"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции на отмену заявки на поставку. |
| error_reasons | Array of strings Items Enum: "INVALID_ORDER_STATE" "ORDER_IS_VIRTUAL" "ORDER_DOES_NOT_BELONG_TO_CONTRACTOR" "ORDER_DOES_NOT_BELONG_TO_COMPANY" "OTHER_ASYNCHRONOUS_OPERATION_IN_PROGRESS" Причина, по которой не удалось отменить заявку на поставку:
| ||||
object Информация об отмене заявки на поставку. | |||||
| |||||
| status | string Enum: "SUCCESS" "IN_PROGRESS" "ERROR" Статус отмены заявки на поставку. Возможные значения:
| ||||
{- "operation_id": "string"
}{- "error_reasons": [
- "INVALID_ORDER_STATE"
], - "result": {
- "is_order_cancelled": true,
- "supplies": [
- {
- "error_reasons": [
- "INVALID_SUPPLY_STATE"
], - "is_supply_cancelled": true,
- "supply_id": 0
}
]
}, - "status": "SUCCESS"
}Метод для редактирования товарного состава в заявке на поставку.
Чтобы проверить статус редактирования, используйте метод /v1/supply-order/content/update/status.
Array of objects Новый товарный состав заявки на поставку. Максимум 5000 товаров. | |
| order_id | integer <int64> Идентификатор заказа. |
| supply_id | integer <int64> Идентификатор поставки. |
| errors | Array of strings Items Enum: "INVALID_DRAFT_BUNDLE_ID" "SOME_SERVICE_ERROR" "HAS_UTD" "ORDER_SKU_LIMIT" "SAME_SKU" "SUPPLY_LOCKED" "INBOUND_NO_CAPACITY" "INBOUND_LOCK" "SUPPLY_CONTENT_NOT_VALID" "SUPPLY_BELONG_TO_ANOTHER_CONTRACTOR" "SUPPLY_BELONG_TO_ANOTHER_COMPANY" "INCORRECT_SUPPLY_STATE" "INCORRECT_SUPPLY_SOURCE" "INCORRECT_STORAGE_WAREHOUSE" "DEADLINE" "INACTIVE_CONTRACT" "QUANTITY_OUT_OF_RANGE_BOTTOM" "QUANTITY_OUT_OF_RANGE_UPPER" "EMPTY_CONTENT" "NO_SUPPLY_PRODUCT_BUNDLE_ID" "INVALID_VOLUME" "SUPPLY_IS_VIRTUAL" "ORDER_LOCKED" "CONTRACT_IS_NOT_FOUND" "COMPANY_DOES_NOT_BELONGS_TO_CONTRACTOR" "ORDER_IS_NOT_FOUND" "ORDER_DOES_NOT_BELONGS_TO_COMPANY" "SUPPLY_IS_NOT_FOUND" "SUPPLY_DOES_NOT_BELONGS_TO_ORDER" "UTD_IS_UPLOADED" "STORAGE_WAREHOUSE_IS_NOT_WMS" "CONTRACT_IS_NOT_VALID_FOR_HANDLING_ORDERS" "ORDER_DOES_NOT_BELONG_TO_CONTRACTOR" Ошибки при редактировании товарного состава:
|
| operation_id | string Идентификатор операции. |
{- "items": [
- {
- "quant": 0,
- "quantity": 0,
- "sku": 0
}
], - "order_id": 0,
- "supply_id": 0
}{- "errors": [
- "INVALID_DRAFT_BUNDLE_ID"
], - "operation_id": "string"
}Метод для получения статуса редактирования товарного состава.
| operation_id | string Идентификатор операции. |
| errors | Array of strings Items Enum: "INVALID_DRAFT_BUNDLE_ID" "SOME_SERVICE_ERROR" "HAS_UTD" "ORDER_SKU_LIMIT" "SAME_SKU" "SUPPLY_LOCKED" "INBOUND_NO_CAPACITY" "INBOUND_LOCK" "SUPPLY_CONTENT_NOT_VALID" "SUPPLY_BELONG_TO_ANOTHER_CONTRACTOR" "SUPPLY_BELONG_TO_ANOTHER_COMPANY" "INCORRECT_SUPPLY_STATE" "INCORRECT_SUPPLY_SOURCE" "INCORRECT_STORAGE_WAREHOUSE" "DEADLINE" "INACTIVE_CONTRACT" "QUANTITY_OUT_OF_RANGE_BOTTOM" "QUANTITY_OUT_OF_RANGE_UPPER" "EMPTY_CONTENT" "NO_SUPPLY_PRODUCT_BUNDLE_ID" "INVALID_VOLUME" "SUPPLY_IS_VIRTUAL" "ORDER_LOCKED" Список ошибок при редактировании товарного состава:
|
| new_bundle_id | string Идентификатор нового товарного состава поставки. |
| status | string Enum: "SUCCESS" "IN_PROGRESS" "ERROR" Статус редактирования товарного состава поставки. Возможные статусы:
|
{- "operation_id": "string"
}{- "errors": [
- "INVALID_DRAFT_BUNDLE_ID"
], - "new_bundle_id": "string",
- "status": "SUCCESS"
}Используйте этот метод, если в /v1/supply-order/content/update/status вы получили ошибку SUPPLY_CONTENT_NOT_VALID.
| new_bundle_id required | string Идентификатор нового товарного состава поставки. |
| supply_id required | integer <int64> Идентификатор поставки. |
| editing_errors | Array of strings Default: "UNSPECIFIED" Items Enum: "UNSPECIFIED" "UNKNOWN" "INCORRECT_SUPPLY_STATE" "DEADLINE" "UTD_IS_UPLOADED" "STORAGE_WAREHOUSE_IS_NOT_WMS" "CONTRACT_IS_NOT_VALID_FOR_HANDLING_ORDERS" "SUPPLY_IS_VIRTUAL" "SUPPLY_DOES_NOT_BELONG_TO_COMPANY" "ASSORTMENT_REJECTION_REASON_CORRUPTED_ASSORTMENT" "ASSORTMENT_REJECTION_REASON_STORAGE_BELARUS_SKU_HAS_NO_ANY_FEACN" "ASSORTMENT_REJECTION_REASON_STORAGE_BELARUS_SKU_HAS_NO_SELLER_FEACN" "ASSORTMENT_REJECTION_REASON_TRACEABLE_SKU_HAS_NO_GTIN_BARCODE" "ASSORTMENT_REJECTION_REASON_TRACEABLE_SKU_HAS_NO_MEASUREMENT_UNIT_QUANTITY" Ошибки:
|
object Информация о товарном составе. |
{- "new_bundle_id": "string",
- "supply_id": 0
}{- "editing_errors": [
- "UNSPECIFIED"
], - "validated_assortment": {
- "approved_items": [
- {
- "barcode": "string",
- "item_link": "string",
- "name": "string",
- "offer_id": "string",
- "origin_quantity": 0,
- "origin_total_volume_in_litres": 0,
- "quant": 0,
- "quantity": 0,
- "sku": 0,
- "sku_quantity_limit": 0,
- "total_volume_in_litres": 0
}
], - "rejected_items": [
- {
- "barcode": "string",
- "name": "string",
- "offer_id": "string",
- "origin_quantity": 0,
- "origin_total_volume_in_litres": 0,
- "quantity": 0,
- "rejection_reason": [
- "UNSPECIFIED"
], - "restrictions": {
- "reasons_restrictions": [
- "UNKNOWN"
], - "sku_has_no_sales_in_days": 0,
- "sku_quantity_limit": 0
}, - "sku": 0,
- "total_volume_in_litres": 0
}
], - "total_approved_item_count": 0,
- "total_approved_quantity": 0,
- "total_approved_volume_in_litres": 0,
- "total_rejected_item_count": 0,
- "total_restricted_item_count": 0
}
}Коды маркировки товара в системе «Честный ЗНАК» передаются с криптохвостом. Проверьте, что в запросе коды маркировки сериализованы в соответствии с пунктом 7 стандарта RFC 8259.
Символ <GS> должен кодироваться как последовательность \u001d. Двойное экранирование в виде \\u001d не допускается. Эта логика уже содержится в большинстве JSON-библиотек — проверьте корректность формируемого запроса.
Метод для получения информации по экземплярам товаров из отправления, переданных в методе /v6/fbs/posting/product/exemplar/set.
Используйте метод для получения exemplar_id.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
| multi_box_qty | integer <int32> Количество коробок, в которые упакован товар. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
{- "posting_number": "string"
}{- "multi_box_qty": 0,
- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "marks": [
- {
- "mark": "string",
- "mark_type": "string"
}
], - "rnpt": "string",
- "weight": 0
}
], - "has_imei": true,
- "is_gtd_needed": true,
- "is_jw_uin_needed": true,
- "is_mandatory_mark_needed": true,
- "is_mandatory_mark_possible": true,
- "is_rnpt_needed": true,
- "product_id": 0,
- "quantity": 0,
- "is_weight_needed": true,
- "weight_max": 0,
- "weight_min": 0
}
]
}Метод для получения информации по экземплярам товаров из отправления.
Используйте метод для получения exemplar_id.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
| multi_box_qty | integer <int32> Количество коробок, в которые упакован товар. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
{- "posting_number": "string"
}{- "multi_box_qty": 0,
- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "mandatory_mark": "string",
- "rnpt": "string",
- "jw_uin": "string"
}
], - "is_gtd_needed": true,
- "is_mandatory_mark_needed": true,
- "is_rnpt_needed": true,
- "product_id": 0,
- "quantity": 0
}
]
}Метод для проверки кодов на соответствие требованиям системы «Честный ЗНАК» по количеству и составу символов, а также других маркировок.
Если у вас нет номера грузовой таможенной декларации (ГТД), вы можете его не указывать.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
Array of objects Список товаров. | |||||||||
Array ()
| |||||||||
{- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "gtd": "string",
- "marks": [
- {
- "mark": "string",
- "mark_type": "string"
}
], - "rnpt": "string",
- "weight": 0
}
], - "product_id": 0
}
]
}{- "products": [
- {
- "error": "string",
- "exemplars": [
- {
- "errors": [
- "string"
], - "gtd": "string",
- "marks": [
- {
- "errors": [
- "string"
], - "mark": "string",
- "mark_type": "string",
- "valid": true
}
], - "rnpt": "string",
- "valid": true,
- "weight": 0
}
], - "product_id": 0,
- "valid": true
}
]
}Метод для проверки кодов на соответствие требованиям по количеству и составу символов.
Подробнее об ошибках в Базе знаний продавца
Если у вас нет номера грузовой таможенной декларации (ГТД), вы можете его не указывать.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
object Результат работы метода. | |||
| |||
{- "posting_number": "23281294-0063-2",
- "products": [
- {
- "exemplars": [
- {
- "gtd": "",
- "mandatory_mark": "010290000151642731tVMohkbfFgunB",
- "jw_uin": ""
}
], - "product_id": 476925391
}
]
}{- "result": {
- "products": [
- {
- "product_id": 476925391,
- "exemplars": [
- {
- "mandatory_mark": "010290000151642731tVMohkbfFgunB",
- "jw_uin": "",
- "gtd": "",
- "valid": true,
- "errors": [ ]
}
], - "valid": true,
- "error": ""
}
]
}
}Асинхронный метод:
Чтобы получить результаты проверок, используйте метод /v5/fbs/posting/product/exemplar/status. Для получения данных о созданных экземплярах, используйте метод /v6/fbs/posting/product/exemplar/create-or-get.
Если у вас несколько одинаковых товаров в отправлении, укажите один product_id и массив exemplars для каждого товара из отправления.
Всегда передавайте полный набор данных по экземплярам и продуктам.
Например, в вашей системе 10 экземпляров. Вы передали их для проверки и сохранения. Потом добавили в своей системе ещё 60 экземпляров. При повторной передаче экземпляров для проверки и сохранения укажите все экземпляры: и старые, и только что добавленные.
Код ответа 200 не гарантирует, что данные об экземплярах приняты. Он указывает, что создана задача для добавления информации. Чтобы проверить статус задачи, используйте метод /v5/fbs/posting/product/exemplar/status.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| multi_box_qty | integer <int32> Количество коробок, в которые упакован товар. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
{- "multi_box_qty": 0,
- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "marks": [
- {
- "mark": "string",
- "mark_type": "string"
}
], - "rnpt": "string",
- "weight": 0
}
], - "product_id": 0
}
]
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Асинхронный метод:
Используйте метод только для отправлений в статусе awaiting_packaging, иначе вы получите ошибку INVALID_POSTING_STATE.
Чтобы получить результаты проверок, используйте метод /v4/fbs/posting/product/exemplar/status. Для получения данных о созданных экземплярах, используйте метод /v5/fbs/posting/product/exemplar/create-or-get.
При необходимости укажите номер грузовой таможенной декларации в параметре gtd.
Если его нет, передайте значение is_gtd_absent = true.
Если у вас несколько одинаковых товаров в отправлении, укажите один product_id и массив exemplars для каждого товара из отправления.
Всегда передавайте полный набор данных по экземплярам и продуктам.
Например, в вашей системе 10 экземпляров. Вы передали их для проверки и сохранения. Потом добавили в своей системе ещё 60 экземпляров. При повторной передаче экземпляров для проверки и сохранения укажите все экземпляры: и старые, и только что добавленные.
Отличие от /v4/fbs/posting/product/exemplar/set — вы можете передать в запросе больше информации по экземплярам.
Код ответа 200 не гарантирует, что данные об экземплярах приняты. Он указывает, что создана задача для добавления информации. Чтобы проверить статус задачи, используйте метод /v4/fbs/posting/product/exemplar/status.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| multi_box_qty | integer <int32> Количество коробок, в которые упакован товар. |
| posting_number required | string Номер отправления. |
required | Array of objects Список товаров. |
| result | boolean Результат обработки запроса. |
{- "multi_box_qty": 0,
- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "mandatory_mark": "string",
- "rnpt": "string",
- "jw_uin": "string"
}
], - "is_gtd_needed": true,
- "is_mandatory_mark_needed": true,
- "is_rnpt_needed": true,
- "product_id": 0,
- "quantity": 0
}
]
}{- "result": true
}Асинхронный метод:
Чтобы получить результаты проверок, используйте метод /v4/fbs/posting/product/exemplar/status.
При необходимости укажите номер грузовой таможенной декларации в параметре gtd. Если его нет, передайте значение is_gtd_absent = true.
Если у вас несколько одинаковых товаров в отправлении, укажите один product_id и массив exemplars для каждого товара из отправления.
Всегда передавайте полный набор данных по экземплярам и продуктам.
Например, в вашей системе 10 экземпляров. Вы передали их для проверки и сохранения. Потом добавили в своей системе ещё 60 экземпляров. При повторной передаче экземпляров для проверки и сохранения укажите все экземпляры: и старые, и только что добавленные.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. |
| result | boolean Результат обработки запроса. |
{- "posting_number": "23281294-0063-2",
- "products": [
- {
- "exemplars": [
- {
- "gtd": "",
- "is_gtd_absent": true,
- "jw_uin": "",
- "mandatory_mark": "010290000151642731tVMohkbfFgunB"
}
], - "product_id": 476925391
}
]
}{- "result": true
}Метод для получения статусов добавления экземпляров, переданных в методе /v6/fbs/posting/product/exemplar/set. Также возвращает данные по этим экземплярам.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. | |
| status | string Статус проверки всех экземпляров и доступности сборки:
|
{- "posting_number": "string"
}{- "posting_number": "string",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": 0,
- "gtd": "string",
- "gtd_check_status": "string",
- "gtd_error_codes": [
- "string"
], - "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "marks": [
- {
- "check_status": "string",
- "error_codes": [
- "string"
], - "mark": "string",
- "mark_type": "string"
}
], - "rnpt": "string",
- "rnpt_check_status": "string",
- "rnpt_error_codes": [
- "string"
], - "weight": 0,
- "weight_check_status": "string",
- "weight_error_codes": [
- "string"
]
}
], - "product_id": 0
}
], - "status": "string"
}Метод для получения статусов добавления экземпляров, переданных в методе /v5/fbs/posting/product/exemplar/set. Также возвращает данные по этим экземплярам.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
| posting_number | string Номер отправления. |
Array of objects Список товаров. | |
| status | string Статус проверки всех экземпляров и доступности сборки:
Статус для отправлений после сборки:
Измените данные по экземплярам для отправлений в статусе «Ожидает отгрузки» с помощью методов /v6/fbs/posting/product/exemplar/set и /v1/fbs/posting/product/exemplar/update. |
{- "posting_number": "23281294-0063-2"
}{- "posting_number": "23281294-0063-2",
- "products": [
- {
- "exemplars": [
- {
- "exemplar_id": "",
- "gtd": "",
- "gtd_check_status": "passed",
- "gtd_error_codes": [ ],
- "is_gtd_absent": true,
- "is_rnpt_absent": true,
- "jw_uin": "",
- "jw_uin_check_status": "passed",
- "jw_uin_error_codes": [ ],
- "mandatory_mark": "010290000151642731tVMohkbfFgunB",
- "mandatory_mark_check_status": "passed",
- "mandatory_mark_error_codes": [ ],
- "rnpt": "",
- "rnpt_check_status": "passed",
- "rnpt_error_codes": [ ]
}
], - "product_id": 476925391
}
], - "status": "ship_available"
}Делит заказ на отправления и переводит его в статус awaiting_deliver.
Каждый элемент в packages может содержать несколько элементов products или отправлений.
Каждый элемент в products — это товар, включённый в данное отправление.
Разделить заказ нужно, если:
Чтобы разделить заказ, передайте в массиве packages несколько объектов.
Пример запроса, когда заказ разделять не нужно: 2 товара будут в одном отправлении.
{
"packages": [
{
"products": [
{
"product_id": 185479045,
"quantity": 2
}
]
}
],
"posting_number": "89491381-0072-1"
}Пример запроса, когда заказ нужно разделить: каждый товар будет в отдельном отправлении.
{
"packages": [
{
"products": [
{
"product_id": 185479045,
"quantity": 1
}
]
},
{
"products": [
{
"product_id": 185479045,
"quantity": 1
}
]
}
],
"posting_number": "89491381-0072-1"
} Чтобы внести информацию по экземплярам, используйте метод /v5/fbs/posting/product/exemplar/set.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Список упаковок. Каждая упаковка содержит список отправлений, на которые делится заказ. |
| posting_number required | string Номер отправления. |
object Дополнительная информация. |
Array of objects Дополнительная информация об отправлениях. | |
| result | Array of strings Результат сборки отправлений. |
{- "packages": [
- {
- "products": [
- {
- "product_id": 185479045,
- "quantity": 1
}
]
}
], - "posting_number": "89491381-0072-1",
- "with": {
- "additional_data": true
}
}{- "additional_data": [
- {
- "posting_number": "89491381-0072-1",
- "products": [
- {
- "currency_code": "RUB",
- "mandatory_mark": [
- "123"
], - "name": "string",
- "offer_id": "17125",
- "price": "2000",
- "quantity": 1,
- "sku": 149618972
}
]
}
], - "result": [
- "89491381-0072-1"
]
}Если в запросе передать часть товаров из отправления, метод разделит первичное отправление на две части. В первичном несобранном отправлении останется часть товаров, которую не передали в запросе.
По умолчанию статус созданных отправлений awaiting_packaging — ожидает сборки.
Статус изначального отправления изменится только после изменения статуса отправлений, на которые он разделился.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
Array of objects Список товаров в отправлении. |
| result | string Номера отправлений, сформированные после сборки. |
{- "posting_number": "string",
- "products": [
- {
- "exemplarsIds": [
- "string"
], - "product_id": 0,
- "quantity": 0
}
]
}{- "result": "string"
}Используйте метод после передачи информации по экземплярам методом /v6/fbs/posting/product/exemplar/set, чтобы сохранить обновлённые данные по экземплярам для отправлений в статусе «Ожидает отгрузки».
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number | string Номер отправления. |
{- "posting_number": "string"
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Используйте метод для создания первой FBS отгрузки. В неё попадут все отправления со статусом «Готов к отгрузке». Созданная отгрузка получит статус new.
Для отгрузки в статусе new можно перезаписать состав отправлений методом /v1/carriage/set-postings. Если из отгрузки исключить часть отправлений, они могут попасть в следующую отгрузку.
Чтобы получить список отправлений в отгрузке, используйте метод /v2/posting/fbs/act/get-postings.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| all_blr_traceable | boolean
|
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string <date-time> Дата отгрузки. По умолчанию — текущая дата. |
| carriage_id | integer <int64> Идентификатор перевозки. |
{- "all_blr_traceable": true,
- "delivery_method_id": 0,
- "departure_date": "2019-08-24T14:15:22Z"
}{- "carriage_id": 0
}Используйте метод, чтобы подтвердить отгрузку после её создания. После подтверждения отгрузка перейдёт в статус «Сформирована».
После подтверждения отгрузки вы можете получить лист отгрузки методом /v2/posting/fbs/digital/act/get-pdf и штрихкод отгрузки методом /v2/posting/fbs/act/get-barcode.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id required | integer <int64> Идентификатор отгрузки. |
| containers_count | integer <int32> Количество грузовых мест. Используйте параметр, если вы подключены к доверительной приёмке и отгружаете заказы грузовыми местами. Если вы не подключены к доверительной приёмке, пропустите его. |
{- "carriage_id": 0,
- "containers_count": 0
}{ }| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id | integer <int64> Идентификатор отгрузки. |
| posting_numbers | Array of strings Актуальный список отправлений. |
Array of objects | |||||||
Array ()
| |||||||
{- "carriage_id": 0,
- "posting_numbers": [
- "string"
]
}{- "result": [
- {
- "error": "string",
- "posting_number": "string",
- "result": true
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id | integer <int64> Идентификатор отгрузки. |
| error | string Описание ошибки. |
| carriage_status | string Статус отгрузки. |
{- "carriage_id": 0
}{- "error": "string",
- "carriage_status": "string"
}Используйте метод, чтобы получить список созданных отгрузок для метода доставки и их статусы.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string <date-time> Дата отгрузки. По умолчанию — текущая дата. |
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "delivery_method_id": 0,
- "departure_date": "2019-08-24T14:15:22Z"
}{- "result": [
- {
- "assembly_list_availability": true,
- "can_create_another_carriage": true,
- "carriage_postings_count": 0,
- "carriage_quantum_count": 0,
- "carriages": [
- {
- "id": "string",
- "postings_count": 0,
- "quantum_count": 0,
- "status": "string"
}
], - "cut_in": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0,
- "delivery_method_name": "string",
- "delivery_method_status": "string",
- "departure_date": "2019-08-24T14:15:22Z",
- "dropoff_address": "string",
- "dropoff_change_availability": "string",
- "dropoff_point_id": 0,
- "dropoff_point_type": "string",
- "errors": [
- {
- "code": "string",
- "description": "string",
- "status": "string"
}
], - "first_mile_changing": true,
- "first_mile_type": "string",
- "has_entrusted_acceptance": true,
- "integration_type": "string",
- "is_presort": true,
- "is_rfbs": true,
- "recommended_time_local": "string",
- "recommended_time_utc_offset_in_minutes": 0,
- "cutoff_at": "2019-08-24T14:15:22Z",
- "mandatory_packaged_count": 0,
- "mandatory_packaged_quantum_count": 0,
- "mandatory_postings_count": 0,
- "mandatory_quantum_count": 0,
- "optional_packaged_count": 0,
- "postings_for_another_carriage_count": 0,
- "quantum_for_another_carriage_count": 0,
- "timeslot_from": "2019-08-24T14:15:22Z",
- "timeslot_to": "2019-08-24T14:15:22Z",
- "tpl_provider_icon_url": "string",
- "tpl_provider_name": "string",
- "warehouse_city": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Подтверждает отгрузку и запускает формирование транспортной накладной и штрихкода для отгрузки. Для продавцов из России также запускается формирование листа отгрузки, а для продавцов из СНГ — акта приёма-передачи.
Чтобы сформировать и получить документы, переведите отправление в статус awaiting_deliver.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| containers_count | integer <int32> Количество грузовых мест. Используйте параметр, если вы подключены к доверительной приёмке и отгружаете заказы грузовыми местами. Если вы не подключены к доверительной приёмке, пропустите его. |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. Можно получить с помощью метода /v1/delivery-method/list. |
| departure_date | string <date-time> Дата отгрузки. |
object Результат работы метода. | |||
| |||
{- "containers_count": 1,
- "delivery_method_id": 230039077005,
- "departure_date": "2022-06-10T11:42:06.444Z"
}{- "result": {
- "id": 5819327210249
}
}Метод для получения перевозок, по которым нужно распечатать штрихкод для отгрузки и документы:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id required | integer <int64> Фильтр по методу доставки. Можно получить с помощью метода /v1/delivery-method/list. |
| departure_date | string <date-time> Дата отгрузки. По умолчанию — текущая дата. |
Array of objects Результат работы метода. | |||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||
{- "delivery_method_id": 0,
- "departure_date": "2019-08-24T14:15:22Z"
}{- "result": [
- {
- "carriage_id": 0,
- "carriage_postings_count": 0,
- "carriage_status": "string",
- "cutoff_at": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0,
- "delivery_method_name": "string",
- "errors": [
- {
- "code": "string",
- "status": "string"
}
], - "first_mile_type": "string",
- "has_entrusted_acceptance": true,
- "mandatory_postings_count": 0,
- "mandatory_packaged_count": 0,
- "recommended_time_local": "string",
- "recommended_time_utc_offset_in_minutes": 0,
- "tpl_provider_icon_url": "string",
- "tpl_provider_name": "string",
- "warehouse_city": "string",
- "warehouse_id": 0,
- "warehouse_name": "string",
- "warehouse_timezone": "string"
}
]
}| carriage_id required | integer <int64> Идентификатор перевозки. |
| act_type | string Тип акта приёма-передачи. Актуально для продавцов FBS. |
| all_blr_traceable | boolean
|
| is_waybill_enabled | boolean
|
| is_econom | boolean
|
| arrival_pass_ids | Array of strings <int64> Список идентификаторов пропусков, оформленных на перевозку. |
| available_actions | Array of strings Доступные действия с перевозкой. |
object Возможность отмены. | |
| carriage_id | integer <int64> Идентификатор перевозки. |
| company_id | integer <int64> Идентификатор продавца. |
| containers_count | integer <int32> Количество грузовых мест. |
| created_at | string <date-time> Дата создания перевозки. |
| delivery_method_id | integer <int64> Идентификатор метода доставки. |
| departure_date | string Дата выполнения перевозки. |
| first_mile_type | string Тип первой мили. |
| has_postings_for_next_carriage | boolean
|
| integration_type | string Тип перевозки. |
| is_container_label_printed | boolean
|
| is_partial | boolean
|
| partial_num | integer <int64> Порядковый номер частичной перевозки. |
| retry_count | integer <int32> Количество повторных попыток создания перевозки. |
| status | string Статус перевозки:
|
| tpl_provider_id | integer <int64> Идентификатор провайдера доставки. |
| updated_at | string <date-time> Дата последнего обновления информации о перевозке. |
| warehouse_id | integer <int64> Идентификатор склада. |
{- "carriage_id": 0
}{- "act_type": "string",
- "all_blr_traceable": true,
- "is_waybill_enabled": true,
- "is_econom": true,
- "arrival_pass_ids": [
- "string"
], - "available_actions": [
- "string"
], - "cancel_availability": {
- "is_cancel_available": true,
- "reason": "string"
}, - "carriage_id": 0,
- "company_id": 0,
- "containers_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0,
- "departure_date": "string",
- "first_mile_type": "string",
- "has_postings_for_next_carriage": true,
- "integration_type": "string",
- "is_container_label_printed": true,
- "is_partial": true,
- "partial_num": 0,
- "retry_count": 0,
- "status": "string",
- "tpl_provider_id": 0,
- "updated_at": "2019-08-24T14:15:22Z",
- "warehouse_id": 0
}| posting_number required | string Номер отправления. |
required | Array of objects Список отправлений, на которые поделится заказ. За один запрос можно разделить один заказ. |
object Информация об изначальном отправлении. | |
Array of objects Список отправлений, на которые разделился заказ. |
{- "posting_number": "string",
- "postings": [
- {
- "products": [
- {
- "product_id": 0,
- "quantity": 0
}
]
}
]
}{- "parent_posting": {
- "posting_number": "string",
- "products": [
- {
- "product_id": 0,
- "quantity": 0
}
]
}, - "postings": [
- {
- "posting_number": "string",
- "products": [
- {
- "product_id": 0,
- "quantity": 0
}
]
}
]
}Возвращает список отправлений в акте по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | int <int64> Идентификатор акта. Можно получить с помощью метода /v2/posting/fbs/act/list. Нужное значение — в параметре ответа |
Array of objects Информация об отправлениях. | |||||||||||||||||
Array ()
| |||||||||||||||||
{- "id": 900000250859000
}{- "result": [
- {
- "id": 0,
- "multi_box_qty": 0,
- "posting_number": "string",
- "status": "string",
- "seller_error": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "created_at": "2019-08-24T14:15:22Z",
- "products": [
- {
- "name": "string",
- "offer_id": "string",
- "price": "string",
- "quantity": 0,
- "sku": 0
}
]
}
]
}Метод создает этикетки для грузового места.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": 295662811
}{ "content_type": "application/pdf", "file_name": "carriage-containers-20903594.pdf", "file_content": "%PDF-1.4\n%âãÏÓ\n2 0 obj\n<</Length 2992/Filter/FlateDecode>>stream\nxµ}[ێ\u001c·\u0011}¯èç\u0000¦Èb\u0015/ @»+\u0019y0Ë\u0002ù\u0000%q\u0010X\u0001ìü?Ãn²ÉéfÍì(ò®\u001duMÝ/<Å\u0019\u001bòyýY,0Ã?=[ccyýåëå×K¡§\u000bAÂâ؉x\u001dßþqùÛ\u001fÿà-dp¢UÔø\u001aün)¿ùqÙ^üöóåݏùù¿«X¶i\t²JúçåÏøýõÙ$Gxn²\u0011&\u000f¥ÉCj¾§2aæºr&^,~hI²)F¤ù7¥íu£:oÊ\u0013Ùȹ0ûLdB\u001a\u0018y§xk;ë<^Lv)%¼)í\u0014öcyóÎX:\u0018ÚõIXå\u0015\u0013╏\r õɌ5dýÆ\u0016Ê!6Ñpys\u001aÄXYÃ1Ô\r:H©(%U´³bR" }
Метод для получения штрихкода, который нужно показать в пункте выдачи или сортировочном центре при отгрузке отправления.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Идентификатор перевозки. |
| file_content | string Изображение со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": "295662811"
}{ "content_type": "image/png", "file_name": "20913984_barcode.png", "file_content": "PNG\r\n\u001a\n\u0000\u0000\u0000\rIHDR\u0000\u0000\u0003\u0010\u0000\u0000\u0000\u0010\u0000\u0000\u0000\u0000íZ\u000e'\u0000\u0000\u0002pIDATxìÕÁJ\u00031\u0014@Q+þÿ/×E\u0017\u000e¼\u0010u¡-ç¬$£Éˌp?î÷·§t» }ýü¸Ãcåz¹2wOWû\\Ϛ뫧×Ùö;ì|rÇýßîç¼úî{§¬N?í7oìv¸®µ¹Ãùû¹¾ÿÏ9ÿî?a¸ºéê7O&߿É9çÉ\u000eÏáý¯\u0007\u0000à\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000$\u0000 \t\u0004\u0000I \u0000H\u0002\u0001@\u0012\b\u0000@\u0000\u0004\u0002$\u0010\u0000" }
Используйте этот метод, чтобы получить штрихкод из ответа /v2/posting/fbs/act/get-barcode в текстовом виде.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Идентификатор перевозки. |
| result | string Штрихкод в текстовом виде. |
{- "id": "295662811"
}{- "result": "%303%24276481394"
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| id | integer <int64> Номер задания на формирование документов. |
| status | string Cтатус формирования документов:
|
{- "id": 0
}{- "id": 0,
- "status": "string"
}С помощью метода можно получить:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": 22435521842000
}{ "content_type": "application/pdf", "file_name": "20928233.pdf", "file_content": "%PDF-1.4\n%âãÏÓ\n2 0 obj\n<</Length 13528/Filter/FlateDecode>>stream\nxí }[ ¯ä:vÞ{ ÿz\u000e{ { { }\\\\x1d\\\\xde/\\\\xc0{ } } } ]µw\u000fò` 9ój8ö\u0000í$¶\u0003ä燔Dº|\"µo ]ÝØ})D\\\\÷õNHßÿº°ðûoºì¿NñÎsïÝå\u001fþõÇÿù\u0011¯\u000be}ǍÑ\u0017©í¤4âòïÿøãïþËåßÂ7dÇ\u0014÷BðþYËÿ GðKüýßÿt\u0019þñïýñ۟äå¯ÿÑ?Ùq}\u0011Éø¸ê?añ«Ã?ú¯ªøÕN_\r8®.9\u0013¿þ\u001fáÜ]ò?íÛ\u000fç\u0011½Há/V°ø\"qÄø«O\\G\u000bµþDëõ'έ>ñ|}ëïpÆÅæ#³\u0018?ܣDxM>èT?¹ìÏ8ï͇aÞ×ßüöß.øÃo{û¯¯" }
Возвращает список актов по отгрузкам с возможностью отфильтровать отгрузки по периоду, статусу и типу интеграции.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Параметры фильтра. | |
| limit required | integer <int64> <= 50 Максимальное количество актов в ответе. |
Array of objects Результат запроса. | |||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||
{- "filter": {
- "date_from": "2021-08-04",
- "date_to": "2022-08-04",
- "integration_type": "ozon",
- "status": [
- "delivered"
]
}, - "limit": 50
}{- "result": [
- {
- "id": null,
- "delivery_method_id": null,
- "delivery_method_name": "string",
- "integration_type": "string",
- "containers_count": null,
- "status": "string",
- "departure_date": "string",
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "act_type": "string",
- "is_partial": true,
- "has_postings_for_next_carriage": true,
- "partial_num": 0,
- "related_docs": {
- "act_of_acceptance": {
- "created_at": "2019-08-24T14:15:22Z",
- "document_status": "string"
}, - "act_of_mismatch": {
- "created_at": "2019-08-24T14:15:22Z",
- "document_status": "string"
}, - "act_of_excess": {
- "created_at": "2019-08-24T14:15:22Z",
- "document_status": "string"
}
}
}
]
}Вы можете получить документы, если в ответе метода /v2/posting/fbs/digital/act/check-status был один из статусов:
FORMED — перевозка сформирована успешно,CONFIRMED — перевозка подтверждена Ozon,CONFIRMED_WITH_MISMATCH — перевозка принята Ozon с расхождениями.| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
| doc_type | any <string> Тип электронного документа:
|
| file_content | string <byte> Содержание файла в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{- "id": 900000250859000,
- "doc_type": "act_of_acceptance"
}{ "content_type": "application/pdf", "file_name": "20816409_act_of_mismatch.pdf", "file_content": "%PDF-1.4\n%ÓôÌá\n1 0 obj\n<<\n/Creator(Chromium)\n/Producer(PDFsharp 1.50.5147 \\([www.pdfsharp.com|http://www.pdfsharp.com/]\\) \\(Original: Skia/PDF m103\\))\n/CreationDate(D:20230625092529+00'00')\n/ModDate(D:20230625092529+00'00')\n>>\nendobj\n2 0 obj\n<<\n/Type/Page\n/Resources\n<<\n/ProcSet[/PDF/Text/ImageB/ImageC/ImageI]\n/ExtGState\n<<\n/G3 3 0 R\n/G8 8 0 R\n>>\n/XObject\n<<\n/X6 6 0 R\n/X7 7 0 R\n>>\n/Font\n<<\n/F4 4 0 R\n/F5 5 0 R\n>>\n>>\n/MediaBox[0 0 594.96 841.92]\n/Contents 9 0 R\n/StructParents 0\n/Parent 13 0 R\n/Group\n<<\n/CS/DeviceRGB\n/S/Transparency\n>>\n>>\nendobj\n3 0 obj\n<<\n/ca 1\n/BM/Normal\n>>\nendobj\n4 0 obj\n<<\n/Type/Font\n/Subtype/Type0\n/BaseFont/AAAAAA+LiberationSans\n/Encoding/Identity-H\n/DescendantFonts[160 0 R]\n/ToUnicode 161 0 R\n>>\nendobj\n5 0 obj\n<<\n/Type/Font\n/Subtype/Type0\n/BaseFont/BAAAAA+LiberationSans-Bold\n/Encoding/Identity-H\n/DescendantFonts[164 0" }
Возвращает статус формирования штрихкода для отгрузки и документов:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| id required | integer <int64> Номер задания на формирование документов (также идентификатор перевозки) из метода POST /v2/posting/fbs/act/create. |
object Результат работы метода. | |||||||||||||||
| |||||||||||||||
{- "id": 900000250859000
}{- "result": {
- "added_to_act": [
- "true"
], - "removed_from_act": [
- "false"
], - "status": "ready"
}
}Добавить трек-номера к отправлениям. Вы можете передать до 20 трек-номеров за раз.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | Array of objects Массив с парами идентификатор отправления — трек-номер. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "tracking_numbers": [
- {
- "posting_number": "48173252-0033-2",
- "tracking_number": "123123123"
}
]
}{- "result": [
- {
- "error": "",
- "posting_number": "48173252-0033-2",
- "result": true
}
]
}Перевести отправление в статус «Отправлено продавцом». Статус доступен только продавцам с первой милей, продающим из-за рубежа.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Список идентификаторов отправлений. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "47173252-0073-1"
]
}{- "result": [
- {
- "error": null,
- "posting_number": "47173252-0073-1",
- "result": true
}
]
}Перевести отправление в статус «Доставляется», если используется сторонняя служба доставки.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Идентификатор отправления. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "33920157-0018-1"
]
}{- "result": [
- {
- "error": [ ],
- "posting_number": "33920157-0018-1",
- "result": true
}
]
}Перевести отправление в статус «Последняя миля», если используется сторонняя служба доставки.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Идентификатор отправления. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "48173252-0033-2"
]
}{- "result": [
- {
- "error": [ ],
- "posting_number": "48173252-0033-2",
- "result": true
}
]
}Перевести отправление в статус «Доставлено», если используется сторонняя служба доставки.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | Array of strings Идентификатор отправления. |
Array of objects Результат работы метода. | |||||||
Array ()
| |||||||
{- "posting_number": [
- "48173252-0033-2"
]
}{- "result": [
- {
- "error": [ ],
- "posting_number": "48173252-0033-2",
- "result": true
}
]
}Метод для получения доступных дат для переноса доставки и количества доступных переносов.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
object Период дат, доступных для переноса. | |
| remaining_changes_count | integer <int64> Количество оставшихся переносов. |
{- "posting_number": "string"
}{- "delivery_interval": {
- "begin": "2023-03-27T08:43:05.658Z",
- "end": "2023-03-27T08:43:05.658Z"
}, - "remaining_changes_count": 0
}Вы можете изменить дату доставки отправления не больше двух раз.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Новый период для даты доставки. |
| posting_number required | string Номер отправления. |
| result | boolean
|
{- "new_timeslot": {
- "from": "2023-03-25T08:51:56.932Z",
- "to": "2023-03-25T08:51:56.932Z"
}, - "posting_number": "string"
}{- "result": true
}Метод для отправлений, которые доставляет продавец или неинтегрированный перевозчик.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| new_cutoff_date required | string <date-time> Новая дата отгрузки. |
| posting_number required | string Номер отправления. |
| result | boolean
|
{- "new_cutoff_date": "2019-08-24T14:15:22Z",
- "posting_number": "string"
}{- "result": true
}| cursor | string Указатель для выборки следующих данных. |
object Фильтры. | |
| limit required | integer <int32> Ограничение по количеству записей в ответе. По умолчанию — 1000. Максимум — 1000. |
Array of objects Список пропусков для перевозки. | |
| cursor | string Указатель для выборки следующих данных. Если параметр пустой, данных больше нет. |
{- "cursor": "",
- "filter": {
- "arrival_pass_ids": [
- "string"
], - "arrival_reason": "string",
- "dropoff_point_ids": [
- "string"
], - "only_active_passes": true,
- "warehouse_ids": [
- "string"
]
}, - "limit": 1000
}{- "arrival_passes": [
- {
- "arrival_pass_id": 0,
- "arrival_reasons": [
- "string"
], - "arrival_time": "2019-08-24T14:15:22Z",
- "driver_name": "string",
- "driver_phone": "string",
- "dropoff_point_id": 0,
- "is_active": true,
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "warehouse_id": 0
}
], - "cursor": "string"
}Идентификатор созданного пропуска добавится к перевозке.
required | Array of objects Список пропусков. |
| carriage_id required | integer <int64> Идентификатор перевозки. |
| arrival_pass_ids | Array of strings <int64> Идентификаторы пропусков. |
{- "arrival_passes": [
- {
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "with_returns": true
}
], - "carriage_id": 0
}{- "arrival_pass_ids": [
- "string"
]
} required | Array of objects Список пропусков. |
| carriage_id required | integer <int64> Идентификатор перевозки. |
Пропуск обновлён
{- "arrival_passes": [
- {
- "driver_name": "string",
- "driver_phone": "string",
- "id": 0,
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "with_returns": true
}
], - "carriage_id": 0
}{ }| arrival_pass_ids required | Array of strings <int64> Идентификаторы пропусков. |
| carriage_id required | integer <int64> Идентификатор перевозки. |
Пропуск удалён
{- "arrival_pass_ids": [
- "string"
], - "carriage_id": 0
}{ } required | Array of objects Список пропусков. |
| arrival_pass_ids | Array of strings <int64> Идентификаторы пропусков. |
{- "arrival_passes": [
- {
- "arrival_time": "2019-08-24T14:15:22Z",
- "driver_name": "string",
- "driver_phone": "string",
- "dropoff_point_id": 0,
- "vehicle_license_plate": "string",
- "vehicle_model": "string",
- "warehouse_id": 0
}
]
}{- "arrival_pass_ids": [
- "string"
]
} required | Array of objects Список пропусков. |
{- "arrival_passes": [
- {
- "arrival_pass_id": 0,
- "arrival_time": "2019-08-24T14:15:22Z",
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_license_plate": "string",
- "vehicle_model": "string"
}
]
}{ }| arrival_pass_ids required | Array of strings <int64> Идентификаторы пропусков. |
{- "arrival_pass_ids": [
- "string"
]
}{ }Метод для получения информации о возвратах FBO и FBS.
object Фильтры. Используйте только один фильтр в запросе: | |
| limit required | integer <int32> Количество подгружаемых возвратов. Максимальное значение — 500. |
| last_id | integer <int64> Идентификатор последнего подгруженного возврата. |
Array of objects Информация о возвратах. | |
| has_next | boolean
|
{- "filter": {
- "logistic_return_date": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "storage_tariffication_start_date": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "visual_status_change_moment": {
- "time_from": "2019-08-24T14:15:22Z",
- "time_to": "2019-08-24T14:15:22Z"
}, - "order_id": "0",
- "posting_numbers": [
- "string"
], - "product_name": "string",
- "offer_id": "string",
- "visual_status_name": "string",
- "warehouse_id": "911",
- "barcode": "string",
- "return_schema": "FBO"
}, - "limit": 500,
- "last_id": 0
}{- "returns": [
- {
- "exemplars": [
- {
- "id": "1019562967545956"
}
], - "id": "1000015552",
- "company_id": "3058",
- "return_reason_name": "Покупатель отказался при вручении: недоволен качеством товара",
- "type": "FullReturn",
- "schema": "Fbs",
- "order_id": "24540784250",
- "order_number": "58544282-0057",
- "place": {
- "id": "23869688194000",
- "name": "СЦ_Львовский_Возвраты",
- "address": "Россия, обл. Московская, г. Подольск, промышленная зона Львовский, ул. Московская, д. 69, стр. 5"
}, - "target_place": {
- "id": "23869688194000",
- "name": "СЦ_Львовский_Возвраты",
- "address": "Россия, обл. Московская, г. Подольск, промышленная зона Львовский, ул. Московская, д. 69, стр. 5"
}, - "storage": {
- "sum": {
- "currency_code": "RUB",
- "price": "1231"
}, - "tariffication_first_date": "2024-07-30T06:15:48.998146Z",
- "tariffication_start_date": "2024-07-29T06:15:48.998146Z",
- "arrived_moment": "2024-07-29T06:15:48.998146Z",
- "days": "0",
- "utilization_sum": {
- "currency_code": "RUB",
- "price": "1231"
}, - "utilization_forecast_date": "2024-07-29T06:15:48.998146Z"
}, - "product": {
- "sku": "1100526203",
- "offer_id": "81451",
- "name": "Кукла Дотти Плачущий младенец Cry Babies Dressy Dotty",
- "price": {
- "currency_code": "RUB",
- "price": "3318"
}, - "price_without_commission": {
- "currency_code": "RUB",
- "price": "3318"
}, - "commission_percent": "1.2",
- "commission": {
- "currency_code": "RUB",
- "price": "2312"
}, - "quantity": 1
}, - "logistic": {
- "technical_return_moment": "2024-07-29T06:15:48.998146Z",
- "final_moment": "2024-07-29T06:15:48.998146Z",
- "cancelled_with_compensation_moment": "2024-07-29T06:15:48.998146Z",
- "return_date": "2024-07-29T06:15:48.998146Z",
- "barcode": "ii5275210303"
}, - "visual": {
- "status": {
- "id": 3,
- "display_name": "В пункте выдачи",
- "sys_name": "ArrivedAtReturnPlace"
}, - "change_moment": "2024-07-29T06:15:48.998146Z"
}, - "additional_info": {
- "is_opened": true,
- "is_super_econom": false
}, - "source_id": "90426223",
- "posting_number": "58544282-0057-1",
- "clearing_id": "21190893156000",
- "return_clearing_id": null,
- "compensation_status": {
- "status": {
- "id": 2,
- "display_name": "Вы получили компенсацию",
- "sys_name": "Received"
}, - "change_moment": "2025-11-06T16:06:56.639Z"
}
}
], - "has_next": false
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| last_id | integer <int32> Идентификатор последнего значения на странице — |
| limit required | integer <int32> Количество значений в ответе. |
object Данные о заявках. | |||||||||||||||||
| |||||||||||||||||
{- "filter": {
- "offer_id": "string",
- "posting_number": "string",
- "group_state": [
- "ALL"
], - "created_at": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}
}, - "last_id": 0,
- "limit": 1000
}{- "returns": [
- {
- "client_name": "string",
- "created_at": "2025-09-03T06:59:05.132Z",
- "order_number": "string",
- "posting_number": "string",
- "product": {
- "currency_code": "string",
- "name": "string",
- "offer_id": "string",
- "price": 0,
- "sku": 0
}, - "return_id": 0,
- "return_number": "string",
- "state": {
- "group_state": "string",
- "money_return_state_name": "string",
- "state": "string",
- "state_name": "string"
}
}
]
}| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. Получите методом /v2/returns/rfbs/list. |
object Данные о заявке. | |||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||
{- "return_id": 0
}{- "returns": {
- "available_actions": [
- {
- "action": {
- "id": 0,
- "name": "string"
}
}
], - "client_name": "string",
- "client_photo": [
- "string"
], - "client_return_method_type": {
- "id": 0,
- "name": "string"
}, - "comment": "string",
- "created_at": "2025-09-04T13:49:20.340Z",
- "order_number": "string",
- "posting_number": "string",
- "product": {
- "currency_code": "string",
- "name": "string",
- "offer_id": "string",
- "price": 0,
- "sku": 0
}, - "rejection_comment": "string",
- "rejection_reason": [
- {
- "hint": "string",
- "id": 0,
- "is_comment_required": true,
- "name": "string"
}
], - "return_method_description": "string",
- "return_number": "string",
- "return_reason": {
- "id": 0,
- "is_defect": true,
- "name": "string"
}, - "ru_post_tracking_number": "string",
- "state": {
- "state": "string",
- "state_name": "string"
}, - "warehouse_id": 0
}
}Метод позволяет отклонить заявку на возврат rFBS-заказа. Вы можете объяснить своё решение в параметре comment.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
| comment | string Комментарий. Передайте комментарий, если в ответе метода /v2/returns/rfbs/get параметр |
| rejection_reason_id required | integer <int64> Идентификатор причины отмены. Передайте идентификатор из списка причин, полученного в ответе метода /v2/returns/rfbs/get в параметре |
{- "return_id": 0,
- "comment": "string",
- "rejection_reason_id": 0
}{ }Метод для частичной компенсации стоимости товара: вы возвращаете часть денег покупателю, товар остаётся у него.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| compensation_amount | string Сумма компенсации. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
{- "compensation_amount": "string",
- "return_id": 0
}{ }Метод позволяет одобрить заявку и согласиться на получение товара для проверки.
Подтвердите получение товара с помощью метода /v2/returns/rfbs/receive-return.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
| return_method_description | string Способ возврата товара. |
{- "return_id": 0,
- "return_method_description": "string"
}{ }| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
{- "return_id": 0
}{ }Метод подтверждает возврат полной стоимости товара. Используйте метод, если согласны:
Если товар оказался ненадлежащего качества или с браком, вы возмещаете покупателю стоимость пересылки товара.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_id required | integer <int64> Идентификатор заявки на возврат. |
| return_for_back_way | integer <int64> Сумма, возмещаемая покупателю за пересылку товара. |
{- "return_id": 0,
- "return_for_back_way": 0
}{ }Метод для передачи действий для возврата rFBS.
| comment | string Комментарий продавца. Обязателен для |
| compensation_amount | number <double> Сумма компенсации. Обязательна для |
| id | integer <int32> Идентификатор действия. Получите доступные действия |
| rejection_reason_id | integer <int32> Идентификатор причины отмены. Обязателен для Получите возможные причины отмены |
| return_for_back_way | number <double> Сумма, возмещаемая покупателю за пересылку товара. Отрицательные значения приравниваются к |
| return_id | integer <int64> Идентификатор заявки на возврат. |
{- "comment": "string",
- "compensation_amount": 0,
- "id": 0,
- "rejection_reason_id": 0,
- "return_for_back_way": 0,
- "return_id": 0
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Метод для получения информации о возвратах FBS и их количестве.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтры. | |
required | object Разделение ответа метода. |
Array of objects Информация о drop-off пунктах. | |
| has_next | boolean Признак, есть ли ещё пункты, где продавца ожидают возвраты. |
{- "filter": {
- "place_id": 0
}, - "pagination": {
- "last_id": 0,
- "limit": 500
}
}{- "drop_off_points": [
- {
- "address": "string",
- "box_count": 0,
- "id": 0,
- "name": "string",
- "pass_info": {
- "count": 0,
- "is_required": true
}, - "place_id": 0,
- "returns_count": 0,
- "utc_offset": "string",
- "warehouses_ids": [
- "string"
]
}
], - "has_next": true
}Если у вас есть доступ, в параметре enabled будет указано значение true.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| enabled | boolean
|
{ }{- "enabled": true
}Метод для получения списка активных возвратов. Возвратная отгрузка становится активной после сканирования штрихкода. После сканирования штрихкода второй раз активная выдача переходит в статус неактивной.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
| limit required | integer <int64> Количество элементов в ответе. |
Array of objects Идентификатор отгрузки. | |||||||||||||||||
Array ()
| |||||||||||||||||
{- "last_id": 0,
- "limit": 500
}{- "giveouts": [
- {
- "approved_articles_count": 0,
- "created_at": "2019-08-24T14:15:22Z",
- "giveout_id": 0,
- "giveout_status": "string",
- "total_articles_count": 0,
- "warehouse_address": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Метод для получения информации о возвратной отгрузке.
В параметр giveout_id передаётся значение, полученное в методе /v1/return/giveout/list.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| giveout_id required | integer <int64> Идентификатор отгрузки. |
Array of objects Артикулы товаров. | |
| giveout_id | integer <int64> Идентификатор отгрузки. |
| giveout_status | string Статусы возвратной отгрузки:
|
| warehouse_address | string Адрес склада. |
| warehouse_name | string Название склада. |
{- "giveout_id": 0
}{- "articles": [
- {
- "approved": true,
- "delivery_schema": "string",
- "name": "string",
- "seller_id": 0
}
], - "giveout_id": 0,
- "giveout_status": "string",
- "warehouse_address": "string",
- "warehouse_name": "string"
}Используйте этот метод, чтобы получить штрихкод из ответа методов /v1/return/giveout/get-png и /v1/return/giveout/get-pdf в текстовом виде.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| barcode | string Значение штрихкода в текстовом виде. |
{ }{- "barcode": "string"
}Возвращает PDF-файл со штрихкодом. Метод работает только для схемы FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| file_content | string PDF-файл со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{ }{ "content_type": "application/pdf", "file_name": "string", "file_content": "string" }
Возвращает PNG-файл со штрихкодом.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| file_content | string PNG-файл со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{ }{ "content_type": "image/png", "file_name": "string", "file_content": "string" }
Используйте метод, если ваш штрихкод попал в посторонние руки.
Метод возвращает PNG-файл с новым штрихкодом. После использования метода вы не сможете получить возвратную отгрузку по старым штрихкодам. Чтобы получить новый штрихкод в PDF-формате, запросите его методом /v1/return/giveout/get-pdf.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| file_content | string Изображение со штрихкодом в бинарном виде. |
| file_name | string Название файла. |
| content_type | string Тип файла. |
{ }{ "content_type": "image/png", "file_name": "string", "file_content": "string" }
Метод для получения списка заявок на отмену rFBS-заказов.
object Фильтры. | |
| last_id | integer <int64> Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| limit required | integer <int32> <= 500 Количество заявок в ответе. |
object Дополнительная информация. |
| counter | integer <int64> Cчётчик заявок в статусе | ||||||||||||||||||||||||||
| last_id | integer <int64> Идентификатор последнего значения на странице. Чтобы получить следующие значения, передайте полученное значение в следующем запросе в параметре | ||||||||||||||||||||||||||
Array of objects Информация о заявках на отмену. | |||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||
{- "filters": {
- "cancellation_initiator": [
- "CLIENT"
], - "posting_number": [
- "34009011-0094-1"
], - "state": "ALL"
}, - "limit": 500,
- "last_id": 0,
- "with": {
- "counter": true
}
}{- "result": [
- {
- "approve_comment": "string",
- "approve_date": "2024-11-27T12:31:43.621Z",
- "auto_approve_date": "2024-11-27T12:31:43.621Z",
- "cancellation_id": 0,
- "cancellation_initiator": "OZON",
- "cancellation_reason": {
- "id": 0,
- "name": "string"
}, - "cancellation_reason_message": "string",
- "cancelled_at": "2024-11-27T12:31:43.621Z",
- "order_date": "2024-11-27T12:31:43.621Z",
- "posting_number": "string",
- "state": {
- "id": 0,
- "name": "string",
- "state": "ALL"
}, - "tpl_integration_type": "string"
}
], - "counter": "1",
- "last_id": 283784254
}Метод позволяет согласовать заявку на отмену в статусе ON_APPROVAL. Заказ будет отменён, а деньги вернутся покупателю.
| cancellation_id required | integer <int64> Идентификатор заявки на отмену. |
| comment | string Комментарий. |
{- "cancellation_id": 0,
- "comment": "string"
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Метод позволяет отклонить заявку на отмену в статусе ON_APPROVAL. В параметре comment опишите причину. Заказ останется в том же статусе, и его нужно будет доставить покупателю.
| cancellation_id required | integer <int64> Идентификатор заявки на отмену. |
| comment | string Комментарий. |
{- "cancellation_id": 0,
- "comment": "string"
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Больше методов в разделе Premium-методы.
Отправляет файл в существующий чат по его идентификатору.
Отправить файл в чат с покупателем могут только продавцы с подпиской Premium Plus или Premium Pro.
Получите список чатов с покупателем chats.chat.chat_type="Buyer_Seller" в ответе метода /v3/chat/list.
Для отправлений:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| base64_content | string Файл в виде строки base64. |
| chat_id required | string Идентификатор чата. |
| name | string Название файла с расширением. |
| result | string Результат обработки запроса. |
{- "base64_content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=",
- "chat_id": "99feb3fc-a474-469f-95d5-268b470cc607",
- "name": "tempor"
}{- "result": "success"
}Возвращает информацию о чатах по указанным фильтрам.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по чатам. | |
| limit required | integer <int64> Количество значений в ответе. Значение по умолчанию — 30. Максимальное значение — 100. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Данные чатов. | |
| total_unread_count | integer <int64> Общее количество непрочитанных сообщений. |
| cursor | string Указатель для выборки следующих данных. |
| has_next | boolean Признак, что в ответе вернулись не все чаты:
|
{- "filter": {
- "chat_status": "Opened",
- "unread_only": true
}, - "limit": 1,
- "cursor": "304000402034"
}{- "chats": [
- {
- "chat": {
- "created_at": "2022-07-22T08:07:19.581Z",
- "chat_id": "5e767w03-b400-4y1b-a841-75319ca8a5c8",
- "chat_status": "Opened",
- "chat_type": "Seller_Support"
}, - "first_unread_message_id": "3000000000118021931",
- "last_message_id": "30000000001280042740",
- "unread_count": 1
}
], - "total_unread_count": 5,
- "cursor": "30000002342123123",
- "has_next": "true"
}Возвращает информацию о чатах по указанным фильтрам.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по чатам. | |
| limit required | integer <int64> Количество значений в ответе. Значение по умолчанию — 30. Максимальное значение — 1000. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Данные чатов. | |
| total_chats_count | integer <int64> Общее количество чатов. |
| total_unread_count | integer <int64> Общее количество непрочитанных сообщений. |
{- "filter": {
- "chat_status": "Opened",
- "unread_only": true
}, - "limit": 1,
- "offset": 0
}{- "chats": [
- {
- "chat": {
- "created_at": "2022-07-22T08:07:19.581Z",
- "chat_id": "5e767w03-b400-4y1b-a841-75319ca8a5c8",
- "chat_status": "Opened",
- "chat_type": "Seller_Support"
}, - "first_unread_message_id": "3000000000118021931",
- "last_message_id": "30000000001280042740",
- "unread_count": 1
}
], - "total_chats_count": 25,
- "total_unread_count": 5
}Возвращает историю сообщений чата. По умолчанию от самого нового сообщения к старым.
История чата с покупателем доступна только для продавцов с подпиской Premium Plus.
Получите список чатов с покупателем chats.chat.chat_type="Buyer_Seller" в ответе метода /v3/chat/list.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| direction | string Направление сортировки сообщений:
Значение по умолчанию — |
| from_message_id | integer <uint64> Идентификатор сообщения, с которого нужно начать вывод истории чата. По умолчанию — последнее видимое сообщение. Параметр |
| limit required | integer <int64> Количество сообщений в ответе. По умолчанию — 50. Максимальное значение — 1000. |
| has_next | boolean Признак, что в ответе вернули не все сообщения. |
Array of objects Массив сообщений, отсортированный в соответствии с параметром |
{- "chat_id": "18b8e1f9-4ae7-461c-84ea-8e1f54d1a45e",
- "direction": "Forward",
- "from_message_id": 3000000000118032000,
- "limit": 1
}{- "has_next": true,
- "messages": [
- {
- "message_id": "3000000000817031942",
- "user": {
- "id": "115568",
- "type": "Сustomer"
}, - "created_at": "2022-07-18T20:58:04.528Z",
- "is_read": true,
- "data": [
- "Здравствуйте, у меня вопрос по вашему товару \"Стекло защитное для смартфонов\", артикул 11223. Подойдет ли он на данную [ модель ](https://www.ozon.ru/product/smartfon-samsung-galaxy-a03s-4-64-gb-chernyy) телефона?"
]
}
]
}Создание или изменение таможенного счёта-фактуры для возврата НДС продавцам из Турции.
| date required | string <date-time> Дата счёта-фактуры. |
Array of objects HS-коды товаров. | |
| number | string Номер счёта-фактуры. Номер может содержать буквы и цифры, максимальная длина — 50 символов. |
| posting_number required | string Номер отправления. |
| price | number <double> Стоимость, указанная в счёте-фактуре. Разделитель дробной части — точка, до двух знаков после точки. |
| price_currency | string Валюта счёта-фактуры:
Значение по умолчанию — |
| url required | string Ссылка на счёт-фактуру. Чтобы создать ссылку, используйте метод v1/invoice/file/upload. |
| result | boolean Результат работы метода. |
{- "HS_code": [
- {
- "sku": "SKU123",
- "code": "534758761999"
}, - {
- "sku": "SKU456",
- "code": "534758761000"
}, - {
- "sku": "SKU789",
- "code": "534758761777"
}
], - "date": "2023-08-01T12:08:44.342Z",
- "number": "424fdsf234",
- "posting_number": "33920146-0252-1",
- "price": 234.34,
- "price_currency": "RUB",
}{- "result": true
}Доступные форматы: JPEG и PDF. Максимальный размер файла: 10 МБ.
| base64_content required | string Счёт-фактура в кодировке Base64. |
| posting_number required | string Номер отправления. |
| url | string Ссылка на счёт-фактуру. |
{- "base64_content": "string",
- "posting_number": "string"
}{- "url": "string"
}| posting_number required | string Номер отправления. |
object Информация о счёте-фактуре. | |||||||||||||
| |||||||||||||
{- "posting_number": "string"
}{- "result": {
- "date": "2019-08-24T14:15:22Z",
- "file_url": "string",
- "hs_codes": [
- {
- "code": "string",
- "sku": "string"
}
], - "number": "string",
- "price": 0,
- "price_currency": "string"
}
}| posting_number required | string Номер отправления. |
| result | boolean Результат работы метода. |
{- "posting_number": "string"
}{- "result": true
}Возвращает информацию о созданном ранее отчёте по его идентификатору.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| code required | string Уникальный идентификатор отчёта. |
object Информация об отчёте. | |||||||||||||||||
| |||||||||||||||||
{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}{- "result": {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27",
- "status": "success",
- "error": "",
- "expires_at": "2025-11-10T11:16:00.267Z",
- "report_type": "seller_products",
- "params": { },
- "created_at": "2021-11-25T14:54:55.688260Z"
}
}Возвращает список отчётов, которые были сформированы раньше.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| page required | integer <int32> Номер страницы. |
| page_size required | integer <int32> Количество значений на странице:
|
| report_type | string Default: "ALL" Тип отчёта:
|
object Результаты запроса. | |||||
| |||||
{- "page": 1,
- "page_size": 1000,
- "report_type": "ALL"
}{- "result": {
- "reports": [
- {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69",
- "status": "success",
- "error": "",
- "expires_at": "2025-11-10T11:35:10.028Z",
- "report_type": "seller_products",
- "params": {
- "visibility": "3"
}, - "created_at": "2019-02-06T12:09:47.258062Z"
}, - {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69",
- "status": "success",
- "error": "",
- "report_type": "seller_products",
- "params": {
- "visibility": "3"
}, - "created_at": "2019-02-15T08:34:32.267178Z"
}
], - "total": 2
}
}Метод для получения отчёта с данными о товарах. Например, Ozon ID, количества товаров, цен, статуса. Соответствует разделу/действию Товары и цены → Список товаров → Скачать → Товары CSV в личном кабинете.
Пояснения к некоторым полям:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| language | string Default: "DEFAULT" Язык ответа:
|
| offer_id | Array of strings Идентификатор товара в системе продавца — артикул. |
| search | string Поиск по содержанию записи, проверяет наличие. |
| sku | Array of integers <int64> Идентификатор товара в системе Ozon — SKU. |
| visibility | string Default: "ALL" Фильтр по видимости товара:
|
object Результаты запроса. | |||
| |||
{- "language": "DEFAULT",
- "offer_id": [ ],
- "search": "",
- "sku": [ ],
- "visibility": "ALL"
}{- "result": {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}
}Метод для получения отчёта о возвратах FBO и FBS.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "filter": {
- "delivery_schema": "fbs",
- "date_from": "2024-09-16T00:00:00.000Z",
- "date_to": "2024-09-19T23:59:59.999Z",
- "status": "MovingToSeller"
}, - "language": "DEFAULT"
}{- "result": {
- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}
}Отчёт об отправлениях с информацией по заказам:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Фильтр. |
| language | string Default: "DEFAULT" Язык ответа:
|
object Дополнительные поля, которые нужно добавить в ответ. |
object Результаты запроса. | |||
| |||
{- "filter": {
- "processed_at_from": "2021-09-02T17:10:54.861Z",
- "processed_at_to": "2021-11-02T17:10:54.861Z",
- "delivery_schema": [
- "fbo"
], - "is_express": true,
- "sku": [ ],
- "cancel_reason_id": [ ],
- "offer_id": "",
- "status_alias": [ ],
- "statuses": [ ],
- "title": ""
}, - "language": "DEFAULT",
- "with": {
- "additional_data": false,
- "analytics_data": false,
- "customer_data": false,
- "jewelry_codes": false
}
}{- "result": {
- "code": "REPORT_seller_postings_514893_1722847571_32a3508c-6b53-408c-a212-6c97138d23ed"
}
}Метод для получения финансового отчёта за периоды с 01 по 15 и с 16 по 31. Запросить отчёт за отдельные дни не получится. Соответствует разделу Финансы → Выплаты в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Период формирования отчёта. |
| page required | integer <int32> Номер страницы, возвращаемой в запросе. |
| with_details | boolean
|
| page_size required | integer <int32> Количество элементов на странице. |
object Результат работы метода. | |||||||
| |||||||
{- "date": {
- "from": "2022-01-01T00:00:00.000Z",
- "to": "2022-12-31T00:00:00.000Z"
}, - "with_details": true,
- "page": 1,
- "page_size": 1
}{- "result": {
- "cash_flows": [
- {
- "commission_amount": 1437,
- "currency_code": "string",
- "item_delivery_and_return_amount": 1991,
- "orders_amount": 1000,
- "period": {
- "begin": "2023-04-03T09:12:10.239Z",
- "end": "2023-04-03T09:12:10.239Z",
- "id": 11567022278500
}, - "returns_amount": -3000,
- "services_amount": 8471.28
}
], - "details": {
- "period": {
- "begin": "2023-04-03T09:12:10.239Z",
- "end": "2023-04-03T09:12:10.239Z",
- "id": 11567022278500
}, - "payments": [
- {
- "payment": 0,
- "currency_code": "string"
}
], - "begin_balance_amount": 0,
- "delivery": {
- "total": 0,
- "amount": 0,
- "delivery_services": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}
}, - "return": {
- "total": 0,
- "amount": 0,
- "return_services": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}
}, - "loan": 0,
- "invoice_transfer": 0,
- "rfbs": {
- "total": 0,
- "transfer_delivery": 0,
- "transfer_delivery_return": 0,
- "compensation_delivery_return": 0,
- "partial_compensation": 0,
- "partial_compensation_return": 0
}, - "services": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}, - "others": {
- "total": 0,
- "items": [
- {
- "name": "string",
- "price": 0
}
]
}, - "end_balance_amount": 0
}
}, - "page_count": 15
}Запускает генерацию отчёта по уценённым товарам на складе Ozon. Ozon может сам уценить товар, например, при повреждении.
В результате запроса будет не сам отчёт, а его уникальный идентификатор. Чтобы получить отчёт, отправьте идентификатор в запросе метода /v1/report/info.
С одного аккаунта продавца можно отправить 1 запрос в минуту. Соответствует разделу Аналитика → Отчёты → Продажи со склада Ozon → Товары, уценённые Ozon в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| code | string Уникальный идентификатор отчёта. Чтобы получить отчёт, передайте это значение в метод /v1/report/info. |
{ }{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}Отчёт с информацией о количестве доступных и зарезервированных единиц товара на складе. Соответствует разделу FBS → Управление логистикой → Управление остатками → Скачать в XLS в личном кабинете.
В результате запроса будет не сам отчёт, а его уникальный идентификатор. Чтобы получить отчёт, отправьте идентификатор в запросе метода /v1/report/info.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| language | string Default: "DEFAULT" Язык ответа:
|
| warehouseId required | string <= 50 characters Идентификаторы складов. Ограничение значений в запросе. Максимум — 50. |
object Результаты запроса. | |||
| |||
{- "language": "DEFAULT",
- "warehouseId": "string"
}{- "code": "REPORT_seller_products_924336_1720170405_a9ea2f27-a473-4b13-99f9-d0cfcb5b1a69"
}Больше методов в разделе Premium-методы.
Метод для получения отчёта по остаткам и товарам в перемещении по складам Ozon.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | integer <int64> Количество ответов на странице. По умолчанию — 100. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| warehouse_type | string Default: "ALL" Enum: "ALL" "EXPRESS_DARK_STORE" "NOT_EXPRESS_DARK_STORE" Фильтр по типу склада:
|
object Результат запроса. | |||
| |||
{- "limit": 1000,
- "offset": 0,
- "warehouse_type": "ALL"
}{- "result": {
- "rows": [
- {
- "free_to_sell_amount": 0,
- "item_code": "string",
- "item_name": "string",
- "promised_amount": 0,
- "reserved_amount": 0,
- "sku": 0,
- "warehouse_name": "string"
}
]
}
}Используйте метод, чтобы узнать оборачиваемость товара и количество дней, на которое хватит текущего остатка.
Метод соответствует разделу FBO -> Управление остатками в личном кабинете.
Вы можете делать не больше 1 запроса в минуту по одному кабинету Client-Id.
Если вы запрашиваете список товаров по sku, параметры limit и offset необязательны.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений в ответе. |
| offset | integer <int32> Количество элементов, которое будет пропущено в ответе. Например, если |
| sku | Array of strings <int64> Идентификаторы товаров в системе Ozon — SKU. |
Array of objects Товары. | |||||||||||||||||||
Array ()
| |||||||||||||||||||
{- "limit": 1,
- "offset": 0,
- "sku": [
- "string"
]
}{- "items": [
- {
- "ads": 0,
- "current_stock": 0,
- "idc": 0,
- "idc_grade": "GRADES_NONE",
- "name": "string",
- "offer_id": "string",
- "sku": 0,
- "turnover": 0,
- "turnover_grade": "GRADES_NONE"
}
]
}Метод позволяет получить аналитику по среднему времени доставки товара до покупателя. Соответствует разделу Аналитика → География продаж → Среднее время доставки в личном кабинете. Детальную аналитику по каждому кластеру можно получить с помощью метода /v1/analytics/average-delivery-time/details.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_schema required | string Default: "All" Enum: "All" "FBO" "FBS" "UNKNOWN" Схема доставки:
|
| sku | Array of strings <int64> <= 100 Идентификатор товара в системе Ozon — SKU. |
| supply_period required | string Default: "FOUR_WEEKS" Enum: "FOUR_WEEKS" "ONE_WEEK" "TWO_WEEKS" "EIGHT_WEEKS" Период поставки в неделях:
|
Array of objects Информация о кластере. | |
object Общие данные. |
{- "delivery_schema": "ALL",
- "sku": [
- "148313766"
], - "supply_period": "FOUR_WEEKS"
}{- "data": [
- {
- "clusters_data": [
- {
- "another_delivery_time": [ ],
- "cluster_id": 147,
- "delivery_time_FBO": 60,
- "delivery_time_FBS": 60,
- "delivery_time_status": "Medium",
- "orders_count": 1,
- "orders_percent": 2
}, - {
- "another_delivery_time": [
- {
- "delivery_time": 28,
- "orders_count": 30,
- "orders_percent": 76,
- "delivery_time_status": "Fast"
}
], - "cluster_id": 154,
- "delivery_time_FBO": 60,
- "delivery_time_FBS": 60,
- "delivery_time_status": "Medium",
- "orders_count": 39,
- "orders_percent": 84
}
], - "delivery_cluster_id": 150,
- "metrics": {
- "average_delivery_time": 46,
- "average_delivery_time_status": "Medium",
- "recommended_supply": 957,
- "orders_count": {
- "total": 46,
- "fast": {
- "value": 12,
- "percent": 26
}, - "medium": {
- "value": 34,
- "percent": 73
}, - "long": {
- "value": 0,
- "percent": 0
}
}, - "impact_share": 30,
- "exact_impact_share": "13.9257",
- "attention_level": "ATTENTION_HI",
- "lost_profit": 1763110
}
}
], - "total": {
- "average_delivery_time": 45,
- "average_delivery_time_status": "Medium",
- "recommended_supply": 18579,
- "orders_count": {
- "total": 201,
- "fast": {
- "value": 105,
- "percent": 52
}, - "medium": {
- "value": 78,
- "percent": 38
}, - "long": {
- "value": 18,
- "percent": 8
}
}, - "impact_share": 100,
- "exact_impact_share": "13.9257",
- "attention_level": "ATTENTION_LOW",
- "lost_profit": 5877036
}
}Метод является аналогом вкладки Аналитика → География продаж → Среднее время доставки в личном кабинете продавца. Подробнее о среднем времени доставки в Базе знаний продавца.
Чтобы получить общую аналитику по кластерам, используйте метод /v1/analytics/average-delivery-time.
| cluster_id required | integer <int64> Идентификатор кластера. |
object Фильтры. | |
| limit required | integer <int32> <= 1000 Default: 100 Количество элементов в ответе. |
| offset required | integer <int32> Default: 0 Количество элементов, которое будет пропущено в ответе.
Например, если |
Array of objects Информация о кластере. | |
| total_rows | integer <int64> Всего записей. |
{- "cluster_id": 154,
- "filters": {
- "delivery_schema": "ALL",
- "supply_period": "EIGHT_WEEKS"
}, - "limit": 1000,
- "offset": 0
}{- "data": [
- {
- "clusters_data": [
- {
- "another_delivery_time": [ ],
- "cluster_id": 154,
- "delivery_time_FBO": 0,
- "delivery_time_FBS": 0,
- "delivery_time_status": "Fast",
- "orders_count": 1,
- "orders_percent": 100
}
], - "item": {
- "name": "Мяч надувной для детей (набор: футбольный, баскетбольный, регби) с насосом",
- "delivery_schema": "ALL",
- "sku": 1423433655,
- "offer_id": "59704000"
}, - "metrics": {
- "average_delivery_time": 31,
- "average_delivery_time_status": "Fast",
- "recommended_supply": 0,
- "orders_count": {
- "total": 1,
- "fast": {
- "value": 1,
- "percent": 100
}, - "medium": {
- "value": 0,
- "percent": 0
}, - "long": {
- "value": 0,
- "percent": 0
}
}, - "impact_share": 0,
- "exact_impact_share": "13.9257",
- "attention_level": "LOW",
- "lost_profit": 0
}
}
], - "total_rows": 10
}Метод позволяет получить общую аналитику по среднему времени доставки товара до покупателя. Соответствует разделу Аналитика → География продаж → Среднее время доставки в личном кабинете.
Детальную аналитику по каждому кластеру можно получить с помощью метода /v1/analytics/average-delivery-time/details. Чтобы получить аналитику по среднему времени доставки, используйте метод /v1/analytics/average-delivery-time.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| average_delivery_time | integer <int32> Среднее время доставки до покупателя. |
object Информация о тарифе. | |
| lost_profit | number <double> Переплата за логистику FBO. |
| perfect_delivery_time | integer <int32> Рекомендуемое среднее время доставки до покупателя. |
| updated_at | string <date-time> Дата и время последнего обновления данных. |
{- "average_delivery_time": 54,
- "perfect_delivery_time": 40,
- "current_tariff": {
- "start": 52,
- "tariff_status": "GOOD",
- "tariff_value": 77.4,
- "fee": 3.87
}, - "updated_at": "0001-01-01T00:00:00Z",
- "lost_profit": 40513
}Больше методов в разделе Premium-методы.
Отчёт о реализации доставленных и возвращённых товаров за месяц. Отмены и невыкупы не включаются. Соответствует разделу Финансы → Документы → Отчёты о реализации → Отчёт о реализации товара в личном кабинете.
Отчёт придёт не позднее 5-го числа следующего месяца.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| month required | integer <int32> Месяц. |
| year required | integer <int32> Год. |
object Результат запроса. | |||||
| |||||
{- "month": 0,
- "year": 0
}{- "result": {
- "header": {
- "contract_date": "string",
- "contract_number": "string",
- "currency_sys_name": "string",
- "doc_amount": 0,
- "doc_date": "string",
- "number": "string",
- "payer_inn": "string",
- "payer_kpp": "string",
- "payer_name": "string",
- "receiver_inn": "string",
- "receiver_kpp": "string",
- "receiver_name": "string",
- "start_date": "string",
- "stop_date": "string",
- "vat_amount": 0
}, - "rows": [
- {
- "commission_ratio": 0,
- "delivery_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "item": {
- "barcode": "string",
- "name": "string",
- "offer_id": "string",
- "sku": 0
}, - "return_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "rowNumber": 0,
- "seller_price_per_instance": 0
}
]
}
}Отчёт о реализации доставленных и возвращённых товаров с детализацией по каждому заказу. Отмены и невыкупы не включаются. Отчёт доступен с настоящего времени по август 2023 года включительно.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| month required | integer <int32> Месяц. |
| year required | integer <int32> Год. |
object Титульный лист отчёта. | |
Array of objects Таблица отчёта. |
{- "month": 2,
- "year": 2025
}{- "header": {
- "contract_date": "string",
- "contract_number": "string",
- "currency_sys_name": "string",
- "doc_amount": 0,
- "doc_date": "string",
- "number": "string",
- "payer_inn": "string",
- "payer_kpp": "string",
- "payer_name": "string",
- "receiver_inn": "string",
- "receiver_kpp": "string",
- "receiver_name": "string",
- "start_date": "string",
- "stop_date": "string",
- "vat_amount": 0
}, - "rows": [
- {
- "commission_ratio": 0,
- "delivery_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "item": {
- "barcode": "string",
- "name": "string",
- "offer_id": "string",
- "sku": 0
}, - "return_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "row_number": 0,
- "seller_price_per_instance": 0,
- "order": {
- "posting_number": "string",
- "created_date": "string"
}, - "legal_entity_document": {
- "number": "string",
- "sale_date": "string"
}
}
]
}Возвращает подробную информацию по всем начислениям. Максимальный период, за который можно получить информацию в одном запросе — 1 месяц.
Если в запросе не указывать posting_number, то в ответе будут все отправления за указанный период или отправления определённого типа.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
posting_number (object) or date (object) Фильтр. | |
| page required | integer <int64> Номер страницы, возвращаемой в запросе. |
| page_size required | integer <int64> <= 1000 Количество элементов на странице. |
object Результаты запроса. | |||||||
| |||||||
{- "filter": {
- "date": {
- "from": "2021-11-01T00:00:00.000Z",
- "to": "2021-11-02T00:00:00.000Z"
}, - "operation_type": [ ],
- "posting_number": "",
- "transaction_type": "all"
}, - "page": 1,
- "page_size": 1000
}{- "result": {
- "operations": [
- {
- "operation_id": 11401182187840,
- "operation_type": "MarketplaceMarketingActionCostOperation",
- "operation_date": "2021-11-01 00:00:00",
- "operation_type_name": "Услуги продвижения товаров",
- "delivery_charge": 0,
- "return_delivery_charge": 0,
- "accruals_for_sale": 0,
- "sale_commission": 0,
- "amount": -6.46,
- "type": "services",
- "posting": {
- "delivery_schema": "",
- "order_date": "",
- "posting_number": "",
- "warehouse_id": 0
}, - "items": [ ],
- "services": [ ]
}
], - "page_count": 1,
- "row_count": 355
}
}Возвращает итоговые суммы по транзакциям за указанный период.
Если вы неправильно заполните номера отправлений, в ответе вернутся нулевые значения.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр по дате. | |
| posting_number required | string Номер отправления. |
| transaction_type | string Тип операции:
|
object Результаты запроса. | |||||||||||||||||
| |||||||||||||||||
{- "date": {
- "from": "2021-11-01T00:00:00.000Z",
- "to": "2021-11-02T00:00:00.000Z"
}, - "posting_number": "",
- "transaction_type": "all"
}{- "result": {
- "accruals_for_sale": 96647.58,
- "sale_commission": -11456.65,
- "processing_and_delivery": -24405.68,
- "refunds_and_cancellations": -330,
- "services_amount": -1307.57,
- "compensation_amount": 0,
- "money_transfer": 0,
- "others_amount": 113.05
}
}Используйте метод, чтобы получить отчёт по продажам юридическим лицам. Соответствует разделу Финансы → Документы → Реестр продаж юр. лицам в личном кабинете.
| date | string Отчётный период в формате |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "date": "string",
- "language": "DEFAULT"
}{- "result": {
- "code": "string"
}
}Используйте метод, чтобы получить отчёт по продажам юридическим лицам в JSON-формате. Соответствует разделу Финансы → Документы → Реестр продаж юр. лицам в личном кабинете.
| date | string Отчётный период в формате |
| date_from | string Дата начала отчётного периода в формате |
| date_to | string Дата окончания отчётного периода в формате |
Array of objects Список счетов-фактур. | |
object Информация о продавце. |
{- "date": "string"
}{- "date_from": "string",
- "date_to": "string",
- "invoices": [
- {
- "buyer_info": {
- "name": "string",
- "address": "string",
- "inn": "string",
- "kpp": "string"
}, - "currency": "string",
- "currency_code": 0,
- "info": {
- "date": "string",
- "number": "string",
- "status": "string",
- "type": "UPD"
}, - "offer_id": "string",
- "operations": [
- {
- "amount": 0,
- "cost_without_vat": 0,
- "date": "string",
- "gtd_number": "string",
- "origin_country": "string",
- "posting_number": "string",
- "price": 0,
- "quantity": 0,
- "rnpt_number": "string",
- "type": "DELIVERY",
- "vat_amount": 0,
- "vat_rate": 0
}
], - "product_name": "string",
- "sku": 0,
- "unit_code": 0,
- "unit_name": "string"
}
], - "seller_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}
}Используйте метод, чтобы получить отчёт о взаиморасчетах. Соответствует разделу Финансы → Документы → Аналитические отчеты → Отчет о взаиморасчетах в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date | string Отчётный период в формате |
| language | string Default: "DEFAULT" Язык ответа:
|
object Результаты запроса. | |||
| |||
{- "date": "string",
- "language": "DEFAULT"
}{- "result": {
- "code": "string"
}
}Возвращает отчёт о товарах, которые выкупил Ozon для продажи в ЕАЭС и другие страны. Соответствует разделу Финансы → Документы → УПД по сделкам с юр. лицами → УПД по выкупленным товарам в личном кабинете.
Подробнее о продаже товаров в ЕАЭС и другие страны в Базе знаний
| date_from required | string Дата, с которой будут данные в отчёте. |
| date_to required | string Дата, по которую будут данные в отчёте. Максимальный период — 31 день. |
Array of objects Список выкупленных товаров | |||||||||||||||||||||
Array ()
| |||||||||||||||||||||
{- "date_from": "YYYY-MM-DD",
- "date_to": "YYYY-MM-DD"
}{- "products": [
- {
- "name": "Футболка Daniele Patrici",
- "offer_id": "y9604060-S",
- "sku": "985111329",
- "posting_number": "0208194185-0001-1",
- "seller_price_per_instance": 95,
- "deduction_by_category_percent": "3.13",
- "buyout_price": 92.3,
- "vat_percent": 20,
- "quantity": 1,
- "amount": 92.3
}, - {
- "name": "Сабо T.TACCARDI",
- "offer_id": "W1496390-41",
- "sku": "1505091950",
- "posting_number": "84189625-0009-3",
- "seller_price_per_instance": 2086,
- "deduction_by_category_percent": "3.01",
- "buyout_price": 2023.3,
- "vat_percent": 20,
- "quantity": 1,
- "amount": 2023.3
}
]
}Метод для получения отчёта о компенсациях. Соответствует отчёту из раздела Финансы → Документы → Компенсации и прочие начисления в личном кабинете.
| date required | string Отчётный период в формате |
| language | string Default: "RU" Язык отчёта:
|
object Результат запроса. | |||
| |||
{- "date": "2023-09",
- "language": "RU"
}{- "result": {
- "code": "string"
}
}Метод для получения отчёта о декомпенсациях. Соответствует отчёту из раздела Финансы → Документы → Компенсации и прочие начисления в личном кабинете.
| date required | string Отчётный период в формате |
| language | string Default: "RU" Язык отчёта:
|
object Результат запроса. | |||
| |||
{- "date": "2023-09",
- "language": "RU"
}{- "result": {
- "code": "string"
}
}Работая с Ozon, продавцы должны соблюдать требования по качеству обслуживания, срокам доставки и общению с клиентами. Система рейтингов отражает качество сервиса продавца, а некоторые показатели видны покупателям — это рейтинг товаров и индекс цен.
Рейтинг продавца по следующим показателям: индекс цен, доставки вовремя, процент отмен, жалобы и другие. Соответствует разделу Рейтинги → Рейтинги продавца в личном кабинете.
Array of objects Список с группами рейтингов. | |
Array of objects Данные по индексу локализации. Если за последние 14 дней у вас не было продаж, поля параметра будут пустыми. | |
| penalty_score_exceeded | boolean Признак, что баланс штрафных баллов превышен. |
| premium | boolean Признак наличия подписки Premium. |
| premium_plus | boolean Признак наличия подписки Premium Plus. |
{ }{- "groups": [
- {
- "group_name": "string",
- "items": [
- {
- "change": {
- "direction": "string",
- "meaning": "string"
}, - "current_value": 0,
- "name": "string",
- "past_value": 0,
- "rating": "string",
- "rating_direction": "string",
- "status": "string",
- "value_type": "string"
}
]
}
], - "localization_index": [
- {
- "calculation_date": "2019-08-24T14:15:22Z",
- "localization_percentage": 0
}
], - "penalty_score_exceeded": true,
- "premium": true,
- "premium_plus": true
}Информация о рейтингах за заданный период и с фильтром по нужному рейтингу. Соответствует разделу Рейтинги → Рейтинги продавца в личном кабинете.
| date_from required | string <date-time> Начало периода. |
| date_to required | string <date-time> Конец периода. |
| ratings required | Array of strings Фильтр по рейтингу. Рейтинги, по которым нужно получить значение за период:
Если вы хотите получить информацию по начисленным штрафным баллам для рейтингов |
| with_premium_scores | boolean Признак, что в ответе нужно вернуть информацию о штрафных баллах в Premium-программе. |
Array of objects Информация о штрафных баллах в Premium-программе. | |
Array of objects Информация о рейтингах продавца. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "ratings": [
- "string"
], - "with_premium_scores": true
}{- "premium_scores": [
- {
- "rating": "string",
- "scores": [
- {
- "date": "2019-08-24T14:15:22Z",
- "rating_value": 0,
- "value": 0
}
]
}
], - "ratings": [
- {
- "danger_threshold": 0,
- "premium_threshold": 0,
- "rating": "string",
- "values": [
- {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "status": {
- "danger": true,
- "premium": true,
- "warning": true
}, - "value": 0
}
], - "warning_threshold": 0
}
]
}Метод доступен только продавцам, работающим с цифровыми товарами. Вы можете загрузить коды цифровых товаров в течение 24 часов с момента получения заказа.
Передайте все коды цифровых товаров к каждому товару в заказе за один запрос. Если передадите не все коды, запрос вернётся с ошибкой.
Array of objects Данные о кодах цифрового товара по SKU. | |
| posting_number | string Номер отправления. |
Array of objects Данные о кодах цифрового товара по SKU. | |||||||||
Array ()
| |||||||||
{- "exemplars_by_sku": [
- {
- "exemplar_qty": 3,
- "not_available_exemplar_qty": 0,
- "sku": "6605735423",
- "exemplar_keys": [
- "4235234234",
- "431234234",
- "912382368"
]
}
], - "posting_number": "33920151-0719-1"
}{- "exemplars_by_sku": [
- {
- "sku": 123456,
- "received_qty": 3,
- "rejected_qty": 1,
- "failed_exemplars": [
- {
- "key": "23434252345",
- "message": "Некорректный формат кода"
}
]
}
]
}Возвращает список отправлений, по которым нужно загрузить коды цифровых товаров. Метод доступен только продавцам, работающим с цифровыми товарами.
Чтобы получить список отправлений в любом статусе, воспользуйтесь методом /v2/posting/fbo/list.
| dir | string Enum: "ASC" "DESC" Направление сортировки:
|
object Фильтр для поиска отправлений. | |
| limit | integer <int64> Количество значений в ответе:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
object Дополнительные поля, которые нужно добавить в ответ. |
Array of objects Список отправлений. | |||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||
{- "dir": "ASC",
- "filter": {
- "since": "2021-09-01T00:00:00.000Z",
- "posting_number": [
- "string"
], - "to": "2021-11-17T10:44:12.828Z"
}, - "limit": 5,
- "offset": 0,
- "with": {
- "analytics_data": true,
- "financial_data": true,
- "legal_info": false
}
}{- "result": [
- {
- "order_id": 354680487,
- "order_number": "16965409-0014",
- "posting_number": "16965409-0014-1",
- "status": "awaiting_packaging",
- "cancel_reason_id": 0,
- "created_at": "2021-09-01T00:23:45.607000Z",
- "in_process_at": "2021-09-01T00:25:30.120000Z",
- "waiting_deadline_for_digital_code": "2025-06-16T10:12:00.664Z",
- "legal_info": {
- "company_name": "string",
- "inn": "string",
- "kpp": "string"
}, - "products": [
- {
- "sku": 160249683,
- "name": "Так говорил Омар Хайям. Жизнеописание. Афоризмы и рубайят. Классика в словах и картинках",
- "offer_id": "978-5-906864-56-7",
- "price": "81.00",
- "required_qty_for_digital_code": 3,
- "currency_code": "RUB"
}
], - "analytics_data": {
- "city": "",
- "delivery_type": "PVZ",
- "is_premium": false,
- "payment_type_group_name": "Карты оплаты",
- "warehouse_id": 17717042026000,
- "warehouse_name": "РОСТОВ-НА-ДОНУ_РФЦ",
- "is_legal": false
}, - "financial_data": {
- "products": [
- {
- "commission_amount": 12.15,
- "commission_percent": 15,
- "payout": 68.85,
- "product_id": 160249683,
- "currency_code": "RUB",
- "old_price": 115,
- "price": 81,
- "total_discount_value": 34,
- "total_discount_percent": 29.57,
- "actions": [
- "Системная виртуальная скидка селлера"
]
}
]
}, - "additional_data": [ ]
}
]
}Метод доступен только продавцам, работающим с цифровыми товарами.
Используйте метод, чтобы изменить информацию о количестве товара в наличии.
Array of objects Данные об остатках. |
Array of objects Информация о товарах. | |||||||||||
Array ()
| |||||||||||
{- "stocks": [
- {
- "stock": "2",
- "offer_id": "Мяч желтый 543561"
}
]
}{- "status": [
- {
- "errors": [ ],
- "offer_id": "Мяч желтый 543561",
- "updated": true,
- "product_id": "29235761",
- "sku": "425291243"
}
]
}Бета-методы Seller API — раздел с методами, которые находятся на стадии тестирования. Такие методы могут работать нестабильно, а их запросы и ответы могут меняться. Об изменениях в работе бета-методов уведомляем за неделю в сообществе разработчиков Ozon for dev. В сообществе вы также можете оставить обратную связь по работе бета-методов и предложить свои идеи.
Бета-методы доступны по API-ключам в зависимости от вашей роли.
Используйте метод, чтобы узнать, сколько товаров осталось на складах FBO.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| limit | integer <int32> [ 1 .. 1000 ] Количество значений в ответе. |
| offset | integer <int32> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Товары. | |||||||||||||||||
Array ()
| |||||||||||||||||
{- "filter": {
- "skus": [
- "string"
], - "stock_types": [
- "STOCK_TYPE_VALID"
], - "warehouse_ids": [
- "string"
]
}, - "limit": 1,
- "offset": 0
}{- "items": [
- {
- "defect_stock_count": 0,
- "expiring_stock_count": 0,
- "name": "string",
- "offer_id": "string",
- "sku": 0,
- "valid_stock_count": 0,
- "waitingdocs_stock_count": 0,
- "warehouse_name": "string"
}
]
}Используйте метод, чтобы получить аналитику по остаткам товаров на складах. Метод соответствует разделу FBO → Управление остатками в личном кабинете. Аналитика обновляется раз в день в 07:00 UTC.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cluster_ids | Array of strings <int64> Фильтр по идентификаторам кластеров. Получить идентификаторы можно через метод /v1/cluster/list. |
| item_tags | Array of strings Items Enum: "ITEM_ATTRIBUTE_NONE" "ECONOM" "NOVEL" "DISCOUNT" "FBS_RETURN" "SUPER" Фильтр по тегам товара:
|
| skus required | Array of strings <int64> <= 100 Фильтр по идентификаторам товаров в системе Ozon — SKU. |
| turnover_grades | Array of strings Items Enum: "TURNOVER_GRADE_NONE" "DEFICIT" "POPULAR" "ACTUAL" "SURPLUS" "NO_SALES" "WAS_NO_SALES" "RESTRICTED_NO_SALES" "COLLECTING_DATA" "WAITING_FOR_SUPPLY" "WAS_DEFICIT" "WAS_POPULAR" "WAS_ACTUAL" "WAS_SURPLUS" Фильтр по статусу ликвидности товаров:
|
| warehouse_ids | Array of strings <int64> Фильтр по идентификаторам складов. Получить идентификаторы можно через метод /v1/warehouse/list. |
Array of objects Информация о товарах. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array ()
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{- "cluster_ids": [
- "string"
], - "item_tags": [
- "ITEM_ATTRIBUTE_NONE"
], - "skus": [
- "string"
], - "turnover_grades": [
- "TURNOVER_GRADE_NONE"
], - "warehouse_ids": [
- "string"
]
}{- "items": [
- {
- "ads": 0,
- "ads_cluster": 0,
- "available_stock_count": 0,
- "cluster_id": 0,
- "cluster_name": "string",
- "days_without_sales": 0,
- "days_without_sales_cluster": 0,
- "excess_stock_count": 0,
- "expiring_stock_count": 0,
- "idc": 0,
- "idc_cluster": 0,
- "item_tags": [
- "ITEM_ATTRIBUTE_NONE"
], - "name": "string",
- "offer_id": "string",
- "other_stock_count": 0,
- "requested_stock_count": 0,
- "return_from_customer_stock_count": 0,
- "return_to_seller_stock_count": 0,
- "sku": 0,
- "stock_defect_stock_count": 0,
- "transit_defect_stock_count": 0,
- "transit_stock_count": 0,
- "turnover_grade": "UNSPECIFIED",
- "turnover_grade_cluster": "UNSPECIFIED",
- "valid_stock_count": 0,
- "waiting_docs_stock_count": 0,
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Возвращает список товаров с некорректными объёмно-весовыми характеристиками (ОВХ). Если вы указали размеры правильно, обратитесь в поддержку Ozon.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
| limit | integer <int64> [ 1 .. 1000 ] Максимальное количество элементов в ответе. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Список товаров. |
{- "cursor": "",
- "limit": 1000
}{- "cursor": "string",
- "products": [
- {
- "height": 0,
- "length": 0,
- "name": "string",
- "offer_id": "string",
- "product_id": 0,
- "sku": 0,
- "weight": 0,
- "width": 0
}
]
}Метод соответствует разделу FBO → Вывоз и утилизация в личном кабинете.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date_from required | string Дата начала отчётного периода в формате |
| date_to required | string Дата окончания отчётного периода в формате |
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, укажите |
| limit required | integer <int32> [ 1 .. 500 ] Количество элементов в ответе. |
| last_id | string Идентификатор последнего значения на странице. |
Array of objects Информация о товарах. |
{- "date_from": "2025-03-01",
- "date_to": "2025-03-30",
- "last_id": "",
- "limit": 500
}{- "returns_summary_report_rows": [
- {
- "name": "Шурупы",
- "offer_id": "Шуруп-0001",
- "sku": "12314324",
- "barcode": "",
- "quantity_for_return": 1,
- "quant_count": 0,
- "box_id": "202501272",
- "return_id": "934457",
- "stock_type": "Излишек",
- "return_created_at": "2025-03-13T06:49:37.591Z",
- "is_auto_return": false,
- "clearing_warehouse_name": "ХОРУГВИНО_РФЦ",
- "return_state": "Отклонено складом",
- "delivery_type": "Вывоз с ПВЗ/СЦ",
- "preliminary_delivery_price": 15,
- "box_length": 0.1,
- "box_width": 0.1,
- "box_height": 0.1,
- "box_volume": 34,
- "box_weight": 0.01,
- "box_state": "Доступно к вывозу",
- "destination_warehouse_name": "РАЗДОРЫ_4",
- "destination_warehouse_address": "Россия, 143082, обл. Московская, р-н Одинцовский, д. Раздоры, Россия, Московская область, Красногорск, улица Липовой Рощи, 2к1",
- "delivery_date": "2025-03-13T06:49:37.591Z",
- "given_out_date": "2025-03-13T06:49:37.591Z",
- "utilization_date": "2025-03-13T06:49:37.591Z"
}
], - "last_id": "whcReturnId:934457_boxId:202501272_itemIndex:0"
}Метод соответствует разделу FBO → Вывоз и утилизация в личном кабинете.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date_from required | string Дата начала отчётного периода в формате |
| date_to required | string Дата окончания отчётного периода в формате |
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, укажите |
| limit required | integer <int32> [ 1 .. 500 ] Количество элементов в ответе. |
| last_id | string Идентификатор последнего значения на странице. |
Array of objects Информация о товарах. |
{- "date_from": "2025-03-01",
- "date_to": "2025-03-30",
- "last_id": "",
- "limit": 500
}{- "returns_summary_report_rows": [
- {
- "name": "Шурупы",
- "offer_id": "Шуруп-0001",
- "sku": "12314324",
- "barcode": "",
- "quantity_for_return": 1,
- "quant_count": 0,
- "box_id": "202501272",
- "return_id": "934457",
- "stock_type": "Излишек",
- "return_created_at": "2025-03-13T06:49:37.591Z",
- "is_auto_return": false,
- "clearing_warehouse_name": "ХОРУГВИНО_РФЦ",
- "return_state": "Отклонено складом",
- "delivery_type": "Вывоз с ПВЗ/СЦ",
- "preliminary_delivery_price": 15,
- "box_length": 0.1,
- "box_width": 0.1,
- "box_height": 0.1,
- "box_volume": 34,
- "box_weight": 0.01,
- "box_state": "Доступно к вывозу",
- "destination_warehouse_name": "РАЗДОРЫ_4",
- "destination_warehouse_address": "Россия, 143082, обл. Московская, р-н Одинцовский, д. Раздоры, Россия, Московская область, Красногорск, улица Липовой Рощи, 2к1",
- "delivery_date": "2025-03-13T06:49:37.591Z",
- "given_out_date": "2025-03-13T06:49:37.591Z",
- "utilization_date": "2025-03-13T06:49:37.591Z"
}
], - "last_id": "whcReturnId:934457_boxId:202501272_itemIndex:0"
}Устанавливает или удаляет скидку на товар в зависимости от его количества в заказе.
Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Информация о скидке от количества по товарам. | |
| suppress_warnings | boolean Передайте |
| accepted | boolean
|
Array of objects Описание ошибок. | |
Array of objects Описание предупреждения. |
{- "stairways": [
- {
- "enabled": true,
- "sku": 0,
- "stairway": {
- "steps": [
- {
- "discount": 0,
- "quantity": 0,
- "step": 0
}
]
}
}
], - "suppress_warnings": true
}{- "accepted": true,
- "errors": [
- {
- "data": [
- {
- "code": "string",
- "field": "string",
- "message": "string",
- "step": 0,
- "value": "string"
}
], - "sku": 0
}
], - "warnings": [
- {
- "data": [
- {
- "code": "string",
- "field": "string",
- "message": "string",
- "step": 0,
- "value": "string"
}
], - "sku": 0
}
]
}Возвращает информацию о скидке на товар в зависимости от его количества в заказе.
Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| skus | Array of strings <int64> <= 5000 items Список идентификаторов товара в системе Ozon — SKU. |
Array of objects Информация о скидке от количества по конкретному товару. | |||||||||
Array ()
| |||||||||
{- "skus": [
- "string"
]
}{- "stairways": [
- {
- "enabled": true,
- "sku": 0,
- "stairway": {
- "steps": [
- {
- "discount": 0,
- "quantity": 0,
- "step": 0
}
]
}, - "status": "IN_PROCESS"
}
]
}В одном отчёте вы можете получить не больше 50 000 кодов маркировки. Чтобы получить остальные данные, уменьшите период формирования отчёта.
Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Период формирования отчёта. |
object Результаты запроса. | |||
| |||
{- "date": {
- "from": "string",
- "to": "string"
}
}{- "result": {
- "code": "string"
}
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
Array of objects Информация об отправлениях. | |||||||
Array ()
| |||||||
{- "posting_number": "string"
}{- "postings": [
- {
- "posting_number": "string",
- "potential_blr_traceable": true,
- "products": [
- {
- "quantity": 0,
- "sku": 0
}
]
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Номер отправления. |
Array of objects Список товаров в отправлении. | |||||
Array ()
| |||||
{- "posting_number": "string"
}{- "products": [
- {
- "required_attributes": [
- "string"
], - "sku": 0
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| carriage_id required | integer <int64> Идентификатор перевозки. |
| errors | Array of strings Ошибки проверки электронной ТТН на прослеживаемой отгрузке. |
| status | string Enum: "NOT_UPLOADED" "PROCESSING" "SUCCESS" "FAILED" Статус проверки электронной ТТН на прослеживаемой отгрузке:
|
{- "carriage_id": 0
}{- "errors": [
- "string"
], - "status": "NOT_UPLOADED"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Компания. | |
Array of objects Список рейтингов. | |
object Подписка. |
{- "company": {
- "country": "string",
- "currency": "string",
- "inn": "string",
- "legal_name": "string",
- "name": "string",
- "ogrn": "string",
- "ownership_form": "string",
- "tax_system": "UNKNOWN"
}, - "ratings": [
- {
- "current_value": {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "formatted": "string",
- "status": {
- "danger": true,
- "premium": true,
- "warning": true
}, - "value": 0
}, - "name": "string",
- "past_value": {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "formatted": "string",
- "status": {
- "danger": true,
- "premium": true,
- "warning": true
}, - "value": 0
}, - "rating": "string",
- "status": "UNKNOWN",
- "value_type": "UNKNOWN"
}
], - "subscription": {
- "is_premium": true,
- "type": "UNKNOWN"
}
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| available_schemas | Array of strings Default: "UNKNOWN" Items Enum: "UNKNOWN" "FBO" "FBS" Тип доступной схемы:
|
| ozon_logistics_enabled | boolean
|
{- "available_schemas": [
- "UNKNOWN"
], - "ozon_logistics_enabled": true
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| currency_code | string Код валюты стоимости обработки ошибок. |
Array of objects Индекс ошибок по дням. | |
| index | number <double> Значение индекса ошибок за период. |
| period_from | string Дата начала расчётного периода в формате |
| period_to | string Дата окончания расчётного периода в формате |
| processing_costs_sum | number <double> Расходы на обработку ошибок за период. |
{- "currency_code": "string",
- "defects": [
- {
- "date": "string",
- "index_by_date": 0,
- "processing_costs_sum_by_date": 0
}
], - "index": 0,
- "period_from": "string",
- "period_to": "string",
- "processing_costs_sum": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
required | object Фильтр. |
| limit required | integer <int64> <= 1000 Количество значений в ответе. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Отправления, которые повлияли на индекс. | |
| has_next | boolean
|
{- "cursor": "string",
- "filter": {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "posting_numbers": [
- "string"
]
}, - "limit": 0
}{- "cursor": "string",
- "errors": [
- {
- "charge_percent": 0,
- "charge_price": 0,
- "charge_price_currency_code": "string",
- "delivery_schema": "string",
- "error_at": "2019-08-24T14:15:22Z",
- "has_grace_status": true,
- "index": 0,
- "posting_error_type": "UNSPECIFIED",
- "posting_number": "string",
- "product_price": 0,
- "product_price_currency_code": "string"
}
], - "has_next": true
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
| limit | integer <uint64> <= 1000 Количество значений в ответе. |
| offer_id | Array of strings <= 1000 items Идентификаторы товаров в системе продавца — артикул. |
| sku required | Array of strings <int64> <= 1000 items Идентификаторы товаров в системе Ozon — SKU. |
| cursor | string Указатель для выборки следующих данных. |
| has_next | boolean
|
Array of objects Остатки товаров. |
{- "cursor": "string",
- "limit": 0,
- "offer_id": [
- "string"
], - "sku": [
- "string"
]
}{- "cursor": "string",
- "has_next": true,
- "products": [
- {
- "free_stock": 0,
- "offer_id": "string",
- "present": 0,
- "product_id": 0,
- "reserved": 0,
- "sku": 0,
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
object Фильтр для поиска методов доставки. | |
| limit required | integer <int64> [ 1 .. 100 ] Количество значений в ответе. |
| sort_dir | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "ASC" "DESC" Направление сортировки:
|
| cursor | string Указатель для выборки следующих данных. |
| has_next | boolean
|
Array of objects Методы доставки. |
{- "cursor": "string",
- "filter": {
- "delivery_method_ids": [
- "string"
], - "provider_ids": [
- "string"
], - "status": [
- "NEW"
], - "warehouse_ids": [
- "string"
]
}, - "limit": 1,
- "sort_dir": "UNSPECIFIED"
}{- "cursor": "string",
- "has_next": true,
- "delivery_methods": [
- {
- "created_at": "2019-08-24T14:15:22Z",
- "cutoff": "string",
- "id": 0,
- "is_express": true,
- "name": "string",
- "provider_id": 0,
- "sla_cut_in": 0,
- "status": "NEW",
- "template_id": 0,
- "tpl_integration_type": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "warehouse_id": 0
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
object Фильтр для поиска методов доставки и отгрузок. | |
| limit required | integer <int64> <= 1000 Количество значений на странице. |
| cursor | string Указатель для выборки следующих данных. |
| has_next | boolean
|
Array of objects Список методов доставки. |
{- "cursor": "string",
- "filter": {
- "delivery_method_id": 0,
- "departure_date": "string"
}, - "limit": 0
}{- "cursor": "string",
- "has_next": true,
- "methods": [
- {
- "carriage_postings_count": 0,
- "carriages": [
- {
- "all_blr_traceable": true,
- "available_actions": [
- "string"
], - "carriage_volume": 0,
- "id": 0,
- "pickup_fee": {
- "currency_code": "string",
- "value": 0
}, - "postings_count": 0,
- "quantum_count": 0,
- "status": "string"
}
], - "cut_in": "string",
- "cutoff_at": "string",
- "delivery_method_id": 0,
- "delivery_method_name": "string",
- "delivery_method_status": "string",
- "departure_date": "string",
- "dropoff_address": "string",
- "dropoff_change_availability": "string",
- "dropoff_point_id": 0,
- "dropoff_point_type": "string",
- "errors": [
- {
- "code": "string",
- "description": "string",
- "status": "string"
}
], - "first_mile_changing": true,
- "first_mile_type": "string",
- "has_entrusted_acceptance": true,
- "integration_type": "string",
- "is_optional_carriage": true,
- "is_presort": true,
- "is_rfbs": true,
- "mandatory_packaged_count": 0,
- "mandatory_postings_count": 0,
- "optional_packaged_count": 0,
- "recommended_time_local": "string",
- "recommended_time_utc_offset_in_minutes": 0,
- "timeslot_from": "string",
- "timeslot_to": "string",
- "tpl_provider_icon_url": "string",
- "tpl_provider_name": "string",
- "warehouse_city": "string",
- "warehouse_id": 0,
- "warehouse_name": "string"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id required | integer <int64> Идентификатор способа доставки. Получите значение параметра методом /v2/delivery-method/list. |
object Информация о возвратных настройках. | |||||||
| |||||||
{- "delivery_method_id": 0
}{- "settings": {
- "courier_details": {
- "contact_days": 0
}, - "post_office_zipcode": "string",
- "transport_company_details": {
- "transport_company_names": [
- "string"
], - "zipcode": "string"
}
}
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| order_id required | integer <int64> Идентификатор заявки на поставку. |
| created_date | string <date-time> Дата создания заявки на поставку. |
| data_filling_deadline_utc | string <date-time> Время в секундах, оставшееся на заполнение данных по поставке. Только для заявок с вРЦ. |
| dropoff_warehouse_id | integer <int64> Идентификатор пункта отгрузки. |
| order_id | integer <int64> Идентификатор заявки на поставку. |
| order_number | string Номер заявки на поставку. |
object Метки заявки на поставку. | |
| state | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "DATA_FILLING" "READY_TO_SUPPLY" "ACCEPTED_AT_SUPPLY_WAREHOUSE" "IN_TRANSIT" "ACCEPTANCE_AT_STORAGE_WAREHOUSE" "REPORTS_CONFIRMATION_AWAITING" "REPORT_REJECTED" "COMPLETED" "REJECTED_AT_SUPPLY_WAREHOUSE" "CANCELLED" "OVERDUE" Статус заявки на поставку:
|
| state_updated_date | string <date-time> Дата обновления статуса заявки на поставку. |
Array of objects Информация о поставках. | |
object Информация о таймслоте. | |
object Информация о водителе и машине. |
{- "order_id": 0
}{- "created_date": "2019-08-24T14:15:22Z",
- "data_filling_deadline_utc": "2019-08-24T14:15:22Z",
- "dropoff_warehouse_id": 0,
- "order_id": 0,
- "order_number": "string",
- "order_tags": {
- "is_econom": true,
- "is_super_fbo": true,
- "is_virtual": true,
- "original_supply_id": 0,
- "product_super_fbo": true
}, - "state": "UNSPECIFIED",
- "state_updated_date": "2019-08-24T14:15:22Z",
- "supplies": [
- {
- "cancellation_allowability": {
- "can_not_set_reasons": [
- "UNSPECIFIED"
], - "can_set": true
}, - "content": {
- "bundle_id": "string",
- "can_not_set_reasons": [
- "UNSPECIFIED"
], - "can_set": true
}, - "ettn_info": {
- "contains_valid": true,
- "is_required": true,
- "is_uploaded": true
}, - "is_crossdock": true,
- "overdue_reason": "UNSPECIFIED",
- "storage_warehouse": {
- "address": "string",
- "arrival_date": "2019-08-24T14:15:22Z",
- "name": "string",
- "warehouse_id": 0
}, - "supply_id": 0,
- "supply_state": "UNSPECIFIED",
- "supply_tags": {
- "is_ettn_required": true,
- "is_evsd_required": true,
- "is_jewelry": true,
- "is_marking_possible": true,
- "is_marking_required": true,
- "is_utd": true
}
}
], - "timeslot": {
- "can_not_set_reasons": [
- "UNSPECIFIED"
], - "can_set": true,
- "value": {
- "timeslot": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}, - "timezone_info": {
- "iana_name": "string",
- "offset": "string"
}
}
}, - "vehicle": {
- "can_not_set_reasons": [
- "UNSPECIFIED"
], - "can_set": true,
- "value": {
- "driver_is_deleted": true,
- "driver_name": "string",
- "driver_phone": "string",
- "vehicle_is_deleted": true,
- "vehicle_model": "string",
- "vehicle_number": "string"
}
}
}Соответствует разделу Финансы → Баланс в личном кабинете.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| date_from required | string <date-time> Дата начала отчётного периода в формате |
| date_to required | string <date-time> Дата окончания отчётного периода в формате |
object Информация о доходах и расходах. | |
object Общие данные по балансу за период. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z"
}{- "cashflows": {
- "returns": {
- "amount": {
- "currency_code": "string",
- "value": 0
}, - "amount_details": {
- "partner_programs": {
- "currency_code": "string",
- "value": 0
}, - "points_for_discounts": "string",
- "revenue": {
- "currency_code": "string",
- "value": 0
}
}, - "fee": {
- "currency_code": "string",
- "value": 0
}
}, - "sales": {
- "amount": {
- "currency_code": "string",
- "value": 0
}, - "amount_details": {
- "partner_programs": {
- "currency_code": "string",
- "value": 0
}, - "points_for_discounts": "string",
- "revenue": {
- "currency_code": "string",
- "value": 0
}
}, - "fee": {
- "currency_code": "string",
- "value": 0
}
}, - "services": [
- {
- "amount": {
- "currency_code": "string",
- "value": 0
}, - "name": "string"
}
]
}, - "total": {
- "accrued": {
- "currency_code": "string",
- "value": 0
}, - "closing_balance": {
- "currency_code": "string",
- "value": 0
}, - "opening_balance": {
- "currency_code": "string",
- "value": 0
}, - "payments": [
- {
- "currency_code": "string",
- "value": 0
}
]
}
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
| limit | integer <int64> Максимальное количество элементов в ответе. |
| visibility | string Default: "ALL" Enum: "ALL" "VISIBLE" "INVISIBLE" "EMPTY_STOCK" "NOT_MODERATED" "MODERATED" "DISABLED" "STATE_FAILED" "READY_TO_SUPPLY" "VALIDATION_STATE_PENDING" "VALIDATION_STATE_FAIL" "VALIDATION_STATE_SUCCESS" "TO_SUPPLY" "IN_SALE" "REMOVED_FROM_SALE" "OVERPRICED" "CRITICALLY_OVERPRICED" "EMPTY_BARCODE" "BARCODE_EXISTS" "QUARANTINE" "ARCHIVED" "OVERPRICED_WITH_STOCK" "PARTIAL_APPROVED" Фильтр по видимости товара:
|
| cursor | string Указатель для выборки следующих данных. |
Array of objects Эконом-товары. | |
| total_items | integer <int32> Остаток на всех складах, шт. |
{- "cursor": "",
- "limit": 1000,
- "visibility": "ALL"
}{- "cursor": "string",
- "products": [
- {
- "offer_id": "string",
- "product_id": 0,
- "quants": [
- {
- "quant_code": "string",
- "quant_size": 0
}
]
}
], - "total_items": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| quant_code required | Array of strings [ 1 .. 1000 ] items Список квантов с товарами. |
Array of objects Эконом-товары. | |||||||
Array ()
| |||||||
{- "quant_code": [
- "string"
]
}{- "items": [
- {
- "offer_id": "string",
- "product_id": 0,
- "quant_info": {
- "quants": [
- {
- "barcodes_extended": [
- {
- "barcode": "string",
- "error": "string",
- "status": "string"
}
], - "dimensions": {
- "depth": 0,
- "height": 0,
- "weight": 0,
- "width": 0
}, - "marketing_price": {
- "price": "string",
- "seller_price": "string"
}, - "min_price": "string",
- "old_price": "string",
- "price": "string",
- "quant_code": "string",
- "quant_sice": 0,
- "shipment_type": "string",
- "sku": 0,
- "statuses": {
- "state_description": "string",
- "state_name": "string",
- "state_sys_name": "string",
- "state_tooltip": "string"
}
}
]
}
}
]
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| mark_review_as_processed | boolean Обновление статуса у отзыва:
|
| parent_comment_id | string Идентификатор родительского комментария, на который вы отвечаете. |
| review_id required | string Идентификатор отзыва. |
| text required | string Текст комментария. |
| comment_id | string Идентификатор комментария. |
{- "mark_review_as_processed": true,
- "parent_comment_id": "string",
- "review_id": "string",
- "text": "string"
}{- "comment_id": "string"
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| comment_id required | string Идентификатор комментария. |
{- "comment_id": "string"
}{ }Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
Метод возвращает информацию по комментариям на отзывы, которые прошли модерацию.
| limit required | integer <int32> Ограничение значений в ответе. Минимум — 20. Максимум — 100. |
| offset | integer <int32> Количество элементов, которое будет пропущено с начала списка в ответе. Например, если |
| review_id required | string Идентификатор отзыва. |
| sort_dir | string Default: "ASC" Enum: "ASC" "DESC" Направление сортировки:
|
Array of objects Информация о комментарии. | |
| offset | integer <int32> Количество элементов в выдаче. |
{- "limit": 100,
- "offset": 0,
- "review_id": "0187310a-97d9-dfcf-3039-82d809f0e233",
- "sort_dir": "ASC"
}{- "comments": [
- {
- "id": "string",
- "is_official": true,
- "is_owner": true,
- "parent_comment_id": "string",
- "published_at": "2019-08-24T14:15:22Z",
- "text": "string"
}
], - "offset": 0
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| review_ids required | Array of strings Массив с идентификаторами отзывов от 1 до 100. |
| status required | string Статус отзыва:
|
{- "review_ids": [
- "string"
], - "status": "string"
}{ }Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| processed | integer <int32> Количество обработанных отзывов. |
| total | integer <int32> Количество всех отзывов. |
| unprocessed | integer <int32> Количество необработанных отзывов. |
{ }{- "processed": 0,
- "total": 0,
- "unprocessed": 0
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| review_id required | string Идентификатор отзыва. |
| comments_amount | integer <int32> Количество комментариев к отзыву. |
| dislikes_amount | integer <int32> Количество дизлайков на отзыве. |
| id | string Идентификатор отзыва. |
| is_rating_participant | boolean
|
| likes_amount | integer <int32> Количество лайков на отзыве. |
| order_status | string Статус заказа, на который покупатель оставил отзыв:
|
Array of objects Информация об изображении. | |
| photos_amount | integer <int32> Количество изображений у отзыва. |
| published_at | string <date-time> Дата публикации отзыва. |
| rating | integer <int32> Оценка отзыва. |
| sku | integer <int64> Идентификатор товара в системе Ozon — SKU. |
| status | string Статус отзыва:
|
| text | string Текст отзыва. |
Array of objects Информация о видео. | |
| videos_amount | integer <int32> Количество видео у отзыва. |
{- "review_id": "string"
}{- "comments_amount": 0,
- "dislikes_amount": 0,
- "id": "string",
- "is_rating_participant": true,
- "likes_amount": 0,
- "order_status": "string",
- "photos": [
- {
- "height": 0,
- "url": "string",
- "width": 0
}
], - "photos_amount": 0,
- "published_at": "2019-08-24T14:15:22Z",
- "rating": 0,
- "sku": 0,
- "status": "string",
- "text": "string",
- "videos": [
- {
- "height": 0,
- "preview_url": "string",
- "short_video_preview_url": "string",
- "url": "string",
- "width": 0
}
], - "videos_amount": 0
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
Метод не возвращает параметры «Достоинства» и «Недостатки», если они есть в отзывах на товар. Эти параметры устарели, в новых отзывах их нет.
| last_id | string Идентификатор последнего отзыва на странице. |
| limit required | integer <int32> Количество отзывов в ответе. Минимум — 20, максимум — 100. |
| sort_dir | string Направление сортировки:
|
| status | string Статусы отзывов:
|
| has_next | boolean
|
| last_id | string Идентификатор последнего отзыва на странице. |
Array of objects Информация об отзыве. |
{- "last_id": "",
- "limit": 100,
- "sort_dir": "ASC",
- "status": "ALL"
}{- "has_next": true,
- "last_id": "string",
- "reviews": [
- {
- "comments_amount": 0,
- "id": "string",
- "is_rating_participant": true,
- "order_status": "string",
- "photos_amount": 0,
- "published_at": "2019-08-24T14:15:22Z",
- "rating": 0,
- "sku": 0,
- "status": "string",
- "text": "string",
- "videos_amount": 0
}
]
}Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| question_id required | string Идентификатор вопроса. |
| sku required | int64 Идентификатор товара в системе Ozon — SKU. |
| text required | string Текст ответа объёмом от 2 до 3000 символов. |
| answer_id | string Идентификатор ответа на вопрос. |
{- "question_id": "string",
- "sku": 0,
- "text": "string"
}{- "answer_id": "0192e7ce-e12c-7a74-afc7-26e877799204"
}Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| answer_id required | string Идентификатор ответа. |
| sku required | int64 Идентификатор товара в системе Ozon — SKU. |
Ответ удалён
{- "answer_id": "0192e7ce-e12c-7a74-afc7-26e877799204",
- "sku": 646399170
}{ }Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| last_id | Идентификатор последнего значения на странице. Если запрос первый, оставьте поле пустым. Для следующих значений указывайте |
| question_id required | string Идентификатор вопроса. |
| sku required | int64 Идентификатор товара в системе Ozon — SKU. |
Array of objects Ответы. | |
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, передайте полученное значение в следующем запросе в параметре |
{- "last_id": "",
- "question_id": "019228a7-91d8-76af-a73a-e989dfac7ac8",
- "sku": 646399170
}{- "answers": [
- {
- "author_name": "string",
- "id": "string",
- "published_at": "2024-08-14T11:44:35.352Z",
- "question_id": "string",
- "sku": 646399170,
- "text": "string"
}
], - "last_id": "string"
}Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| question_ids required | Array of strings Идентификаторы вопросов. |
| status required | string Статусы вопросов:
|
Статус изменён.
{- "question_ids": [
- "string"
], - "status": "VIEWED"
}{ }Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| all | int64 Всего вопросов. |
| new | int64 Новые вопросы. |
| processed | int64 Обработанные вопросы. |
| unprocessed | int64 Необработанные вопросы. |
| viewed | int64 Просмотренные вопросы. |
{- "all": 10,
- "new": 3,
- "processed": 4,
- "unprocessed": 1,
- "viewed": 1
}Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| question_id required | string Идентификатор вопроса |
| answers_count | int64 Количество ответов на вопрос. |
| author_name | string Автор вопроса. |
| id | string Идентификатор вопроса. |
| product_url | string Ссылка на товар. |
| published_at | timestamp Дата публикации вопроса. |
| question_link | string Ссылка на вопрос. |
| sku | int64 Идентификатор товара в системе Ozon — SKU. |
| status | enum Статус вопроса:
|
| text | string Текст вопроса. |
{- "question_id": "string"
}{- "answers_count": "0",
- "author_name": "Пользователь OZON",
- "sku": 646399170,
- "id": "0192a009-769f-7ee9-b412-893045171a66",
- "text": "Можно выбрать цвет?",
- "published_at": "2024-10-08T10:09:29.099284Z",
- "status": "VIEWED"
}Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Фильтр. | |
| last_id | string Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
Array of objects [ 0 .. 10 ] items Вопросы. | |
| last_id | string Идентификатор последнего значения на странице. Чтобы получить следующие значения, передайте полученное значение в следующем запросе в параметре |
{- "filter": {
- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "status": "ALL"
}, - "last_id": ""
}{- "questions": [
- {
- "answers_count": 1,
- "author_name": "Пользователь OZON",
- "id": "019294ff-6888-7009-89d8-26569e4e450d",
- "sku": 646399170,
- "published_at": "2024-08-14T12:02:01.889Z",
- "text": "Новый вопрос о товаре Света",
- "status": "PROCESSED"
}
], - "last_id": "019228a7-91d8-76af-a73a-e989dfac7ac8"
}Доступно для продавцов с подпиской Premium Plus.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | int64 Количество значений в ответе: максимум — 100, минимум — 1. |
| sku | Array of strings <int64> Список идентификаторов товаров в системе Ozon — SKU. |
{- "limit": "100"
}{- "sku": [
- 56371271
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
object Координаты. | |
| country_code required | string Код страны в формате ISO 2. |
| is_kgt required | boolean
|
object Параметры поиска. |
Array of objects Список пунктов. | |||||||||||||
Array ()
| |||||||||||||
{- "country_code": "RU",
- "is_kgt": false,
- "coordinates": {
- "latitude": 55,
- "longitude": 37
}, - "search": {
- "address": "москва",
- "types": [
- "PPZ"
]
}
}{- "points": [
- {
- "address": "Россия, Москва, Москва, Россия, г. Москва, Никольская улица, 7-9 строение 4",
- "discount_percent": 1,
- "id": "1020002487458000",
- "last_transit_time_local": {
- "hours": 12,
- "minutes": 0,
- "nanos": 0,
- "seconds": 0
}, - "coordinates": {
- "latitude": 55.756107,
- "longitude": 37.620426
}, - "type": "PVZ"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
object Параметры поиска. | |
| warehouse_id required | integer <int64> Фильтр по существующему FBS-складу. |
Array of objects Список пунктов. | |||||||||||||
Array ()
| |||||||||||||
{- "search": {
- "address": "москва",
- "types": [
- "PPZ"
]
}, - "warehouse_id": 0
}{- "points": [
- {
- "address": "Россия, Москва, Москва, Россия, г. Москва, Никольская улица, 7-9 строение 4",
- "discount_percent": 1,
- "id": "1020002487458000",
- "last_transit_time_local": {
- "hours": 12,
- "minutes": 0,
- "nanos": 0,
- "seconds": 0
}, - "coordinates": {
- "latitude": 55.756107,
- "longitude": 37.620426
}, - "type": "PVZ"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| drop_off_point_id required | integer <int64> Идентификатор drop-off пункта. |
Array of objects Список таймслотов. | |||||||||||
Array ()
| |||||||||||
{- "drop_off_point_id": 0
}{- "timeslots": [
- {
- "acceptance_end_time_local": "string",
- "acceptance_start_time_local": "string",
- "from": "string",
- "id": 0,
- "to": "string"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| drop_off_point_id required | integer <int64> Идентификатор drop-off пункта. |
| warehouse_id required | integer <int64> Идентификатор склада. |
Array of objects Список таймслотов. | |||||||||||
Array ()
| |||||||||||
{- "drop_off_point_id": 0,
- "warehouse_id": 0
}{- "timeslots": [
- {
- "acceptance_end_time_local": "string",
- "acceptance_start_time_local": "string",
- "from": "string",
- "id": 0,
- "to": "string"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Координаты склада. |
| is_kgt required | boolean Признак крупногабаритного товара. |
| is_pickup_supported | boolean Признак поддержки отгрузки pick-up. |
Array of objects Список таймслотов. |
{- "is_kgt": true,
- "address_coordinates": {
- "latitude": 55.7558,
- "longitude": 37.6173
}
}{- "is_pickup_supported": true,
- "timeslots": [
- {
- "id": 123456789,
- "from": "00:00",
- "to": "00:00"
}, - {
- "id": 987654321,
- "from": "00:00",
- "to": "00:00"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| warehouse_id required | integer <int64> Идентификатор склада. |
Array of objects Список таймслотов. | |||||||
Array ()
| |||||||
{- "warehouse_id": 987654321
}{- "timeslots": [
- {
- "id": 1001,
- "from": "00:00",
- "to": "00:00"
}, - {
- "id": 1002,
- "from": "00:00",
- "to": "00:00"
}
]
}Если создаёте склад с доставкой в drop-off пункт, используйте метод /v1/warehouse/fbs/create/drop-off/list, чтобы получить точки.
Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
required | object Координаты адреса склада. |
| cut_in_time required | integer <int64> Время на приём заказов в минутах. Например, если вы передадите |
| drop_off_point_id | integer <int64> Идентификатор drop-off пункта. |
| first_mile_type required | string Enum: "PICK_UP" "DROP_OFF" Тип первой мили:
|
| is_kgt required | boolean
|
| name required | string Название склада. |
object Параметры склада. | |
| phone required | string Номер телефона склада. Укажите в формате +7(XXX)XXX-XX-XX. |
| timeslot_id required | integer <int64> Идентификатор таймслота. |
| return_point_id | integer <int64> Идентификатор пункта возврата. Получите значение параметра методом /v1/warehouse/fbs/create/return-point/list. |
| working_days | Array of strings <= 7 items Items Enum: "MONDAY" "TUESDAY" "WEDNESDAY" "THURSDAY" "FRIDAY" "SATURDAY" "SUNDAY" Рабочие дни склада:
|
| operation_id | string Идентификатор операции на создание FBS-склада. Чтобы получить статус операции, используйте метод /v1/warehouse/operation/status. |
{- "address_coordinates": {
- "latitude": 55.69626,
- "longitude": 37.42686
}, - "first_mile_type": "DROP_OFF",
- "drop_off_point_id": 1020002487458000,
- "cut_in_time": 0,
- "timeslot_id": 0,
- "return_point_id": 0,
- "is_kgt": false,
- "name": "Склад",
- "options": {
- "comment": "Комментарий",
- "courier_phones": [
- "+7(999)999-99-99"
], - "is_auto_assembly": true,
- "is_waybill_enabled": true
}, - "phone": "+7(999)999-99-99",
- "working_days": [
- "MONDAY",
- "TUESDAY",
- "WEDNESDAY",
- "THURSDAY",
- "FRIDAY"
]
}{- "operation_id": "a0cfefee-9a5a-4580-bc32-2f9a6c7973e3"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
object Координаты склада. | |
| name | string >= 100 characters Название склада. |
object Параметры склада. | |
| phone | string+7(XXX)XXX-XX-XX Номер телефона склада. |
| warehouse_id required | integer <int64> Идентификатор склада. |
| working_days | Array of strings [ 5 .. 7 ] Items Enum: "UNSPECIFIED" "MONDAY" "TUESDAY" "WEDNESDAY" "THURSDAY" "FRIDAY" "SATURDAY" "SUNDAY" Рабочие дни склада:
|
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "address_coordinates": {
- "latitude": 55.69626,
- "longitude": 37.42686
}, - "name": "Склад Балашиха",
- "options": {
- "comment": "Заезд на склад через главные ворота",
- "courier_phones": [
- "+7(999)999-99-99"
], - "is_auto_assembly": true,
- "is_waybill_enabled": true
}, - "phone": "+7(XXX)XXX-XX-XX",
- "warehouse_id": 1020002929332000,
- "working_days": [
- "MONDAY",
- "TUESDAY",
- "WEDNESDAY",
- "THURSDAY",
- "FRIDAY"
]
}{- "operation_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| operation_id required | string Идентификатор операции. |
object Ошибка при обработке операции. | |||
object Результат операции. | |||
| |||
| status | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "IN_PROGRESS" "SUCCESS" "ERROR" Статус операции:
| ||
| type | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "CREATE_FBS_WAREHOUSE" "UPDATE_FBS_WAREHOUSE" "SET_FIRST_MILE" "WAREHOUSE_ENABLE_DISABLE" Тип операции:
| ||
{- "operation_id": "a0cfefee-9a5a-4580-bc32-2f9a6c7973e3"
}{- "error": {
- "code": "string",
- "message": "string"
}, - "result": {
- "warehouse_id": 1020005000219156
}, - "status": "SUCCESS",
- "type": "CREATE_FBS_WAREHOUSE"
}Метод возвращает список складов FBS и rFBS. Чтобы получить список складов FBO, используйте метод /v1/warehouse/fbo/list.
Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | integer <= 200 Количество значений в ответе. |
| cursor | string Указатель для выборки следующих данных. |
| warehouse_ids required | Array of strings <int64> <= 200 Идентификаторы складов. |
| cursor | string Указатель для выборки следующих данных. |
Array of objects Список складов. |
{- "cursor": "string",
- "limit": 0,
- "warehouse_ids": [
- 20605650762000
]
}{- "cursor": "string",
- "warehouses": [
- {
- "address_info": {
- "address": "Россия, Московская Область, Софьино, промзона ССТ, к2, 2",
- "latitude": 55.495093,
- "longitude": 38.172731,
- "utc": "UTC+03:00"
}, - "carriage_label_type": "BIG",
- "courier_comment": "",
- "courier_phones": [
- "+7(999)999-99-99"
], - "created_at": "2025-03-11T11:57:51.811Z",
- "first_mile": {
- "type": "PICK_UP",
- "dropoff_point_id": "1020002075314000",
- "timeslot_from": "20:59",
- "timeslot_id": 287231,
- "timeslot_to": "21:00",
- "first_mile_is_changing": false
}, - "has_entrusted_acceptance": true,
- "has_postings_limit": false,
- "is_auto_assembly": true,
- "is_kgt": true,
- "is_rfbs": true,
- "is_waybill_enabled": true,
- "min_postings_limit": 2,
- "is_comfort": true,
- "is_express": true,
- "warehouse_type": "string",
- "cut_in_time": 0,
- "name": "17023",
- "phone": "+7(999)999-99-99",
- "postings_limit": -1,
- "sla_cut_in": 2939,
- "status": "created",
- "timetable": {
- "timetable_from": "2025-03-11T11:57:51.811Z",
- "timetable_to": "2025-03-11T11:57:51.811Z",
- "working_hours": [
- {
- "time_from": "2025-03-11T11:57:51.811Z",
- "time_to": "2025-03-11T11:57:51.811Z"
}
]
}, - "updated_at": "2025-03-11T11:57:51.811Z",
- "warehouse_id": 20605650762000,
- "with_item_list": true,
- "working_days": [
- "MONDAY",
- "TUESDAY",
- "WEDNESDAY",
- "THURSDAY",
- "FRIDAY"
]
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cut_in_time required | integer <int64> Время на приём заказов в минутах. Например, если вы передадите |
| drop_off_point_id | integer <int64> Идентификатор drop-off пункта. Если |
| first_mile_type required | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "PICK_UP" "DROP_OFF" Тип первой мили:
|
| timeslot_id required | integer <int64> Идентификатор таймслота. |
| return_point_id | integer <int64> Идентификатор пункта возврата. Получите значение параметра методом /v1/warehouse/fbs/update/return-point/list. |
| warehouse_id required | integer <int64> Идентификатор склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "first_mile_type": "DROP_OFF",
- "drop_off_point_id": 0,
- "cut_in_time": 0,
- "timeslot_id": 0,
- "return_point_id": 0,
- "warehouse_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| reason required | string <= 200 characters Причина переноса склада в архив. |
| return_point_id | integer <int64> Идентификатор пункта возврата. Получите значение параметра методом /v1/warehouse/fbs/update/return-point/list. |
| warehouse_id required | integer <int64> Идентификатор склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "reason": "Тестовая причина",
- "warehouse_id": 1020002929332000,
- "return_point_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| return_point_id | integer <int64> Идентификатор пункта возврата. Получите значение параметра методом /v1/warehouse/fbs/update/return-point/list. |
| warehouse_id required | integer <int64> Идентификатор склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "warehouse_id": 1020002929332000,
- "return_point_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| last_id | integer <int64> Идентификатор последнего значения на странице. При первом запросе оставьте это поле пустым. Чтобы получить следующие значения, укажите |
| warehouse_id required | integer <int64> Идентификатор склада. Получите значение параметра методом /v1/warehouse/warehouses-with-invalid-products. |
| has_next | boolean
|
| last_id | integer <int64> Идентификатор последнего значения на странице. Чтобы получить следующие значения, передайте полученное значение в следующем запросе в параметре |
Array of objects Результат проверки. | |
| warehouse_id | integer <int64> Идентификатор склада. |
{- "last_id": 0,
- "warehouse_id": 0
}{- "has_next": true,
- "last_id": 0,
- "validation_results": [
- {
- "item": {
- "size": {
- "height_mm": 0,
- "length_mm": 0,
- "width_mm": 0
}, - "sku": 0,
- "weight_g": 0
}, - "state": "UNSPECIFIED",
- "validation_errors": [
- {
- "characteristic": "UNSPECIFIED",
- "restriction_price": {
- "currency": "string",
- "value": 0
}, - "restriction_vwc": 0,
- "template_id": 0,
- "type": "UNSPECIFIED"
}
]
}
], - "warehouse_id": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Координаты пункта возврата. |
| country_code required | string Код страны в формате ISO 2. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
| limit required | integer <int32> [ 1 .. 500 ] Количество значений в ответе. |
object Параметры поиска. | |
| selected_dropoff_point_id | integer <int64> Идентификатор выбранной точки отгрузки на складе. |
| has_next | boolean Признак, что в ответе вернули не все пункты возврата. |
| is_selected_point_available | boolean Признак доступности пункта возврата. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
Array of objects Список пунктов возврата. |
{- "coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "country_code": "string",
- "last_id": 0,
- "limit": 1,
- "search": {
- "address": "string",
- "types": [
- "UNSPECIFIED"
]
}, - "selected_dropoff_point_id": 0
}{- "has_next": true,
- "is_selected_point_available": true,
- "last_id": 0,
- "points": [
- {
- "address": "string",
- "coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "id": 0,
- "name": "string",
- "type": "UNSPECIFIED",
- "utc_offset": 0,
- "working_days": [
- {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}
]
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| current_dropoff_point_id | integer <int64> Идентификатор выбранной точки отгрузки на складе. |
| current_return_point_id | integer <int64> Установленный пункт возврата. Получите значение параметра методом /v1/warehouse/fbs/return-mile/info. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
| limit required | integer <int32> [ 1 .. 500 ] Количество значений в ответе. |
object Параметры поиска. | |
| warehouse_id required | integer <int64> Идентификатор склада. |
| has_next | boolean Признак, что в ответе вернули не все пункты возврата. |
| is_selected_point_available | boolean Признак доступности пункта возврата для выбора. |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
Array of objects Список пунктов возврата. |
{- "current_dropoff_point_id": 0,
- "current_return_point_id": 0,
- "last_id": 0,
- "limit": 1,
- "search": {
- "address": "string",
- "types": [
- "UNSPECIFIED"
]
}, - "warehouse_id": 0
}{- "has_next": true,
- "is_selected_point_available": true,
- "last_id": 0,
- "points": [
- {
- "address": "string",
- "coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "id": 0,
- "name": "string",
- "type": "UNSPECIFIED",
- "utc_offset": 0,
- "working_days": [
- {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}
]
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| warehouse_ids required | Array of strings <int64> [ 1 .. 1000 ] Идентификаторы складов. |
Array of objects Информация о возвратной миле на складе. | |||||||
Array ()
| |||||||
{- "warehouse_ids": [
- "string"
]
}{- "return_mile_settings": [
- {
- "is_return_mile_required": true,
- "return_point": {
- "address": "string",
- "coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "id": 0,
- "name": "string",
- "type": "UNSPECIFIED",
- "utc_offset": 0,
- "working_days": [
- {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}
]
}, - "warehouse_id": 0
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| country_code required | string Код страны в формате ISO 2. |
| first_mile_type required | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "PICK_UP" "DROP_OFF" Тип первой мили:
|
| is_kgt required | boolean Признак крупногабаритного товара. |
| warehouse_id | integer <int64> Идентификатор склада. |
| should_set_return_mile | boolean Признак, что необходимо установить возвратную милю. |
| unavailability_reasons | Array of strings Причины, по которым нельзя установить возвратную милю. |
{- "country_code": "string",
- "first_mile_type": "UNSPECIFIED",
- "is_kgt": true,
- "warehouse_id": 0
}{- "should_set_return_mile": true,
- "unavailability_reasons": [
- "string"
]
}Возвращает идентификаторы складов, на которых находятся товары с ограничениями. Такие товары недоступны для доставки со склада.
Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| warehouse_ids | Array of strings <int64> Список идентификаторов складов, у которых есть хотя бы 1 товар, который недоступен для доставки со склада. Чтобы получить список товаров с ограничениями, используйте метод /v1/warehouse/invalid-products/get. |
{- "warehouse_ids": [
- "string"
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
required | object Фильтр. |
| limit required | integer <int64> <= 100 Количество значений на странице. |
| can_print_mass_label | boolean
|
| cursor | string Указатель для выборки следующих данных. Если параметр пустой, данных больше нет. |
Array of objects Список отправлений. |
{- "cursor": "string",
- "filter": {
- "carriage_id": 0,
- "cutoff_from": "2019-08-24T14:15:22Z",
- "cutoff_to": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0
}, - "limit": 0
}{- "can_print_mass_label": true,
- "cursor": "string",
- "postings": [
- {
- "assembly_code": "string",
- "can_print_label": true,
- "posting_number": "string",
- "products": [
- {
- "offer_id": "string",
- "picture_url": "string",
- "product_name": "string",
- "quantity": 0,
- "sku": 0
}
]
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
required | object Фильтр. |
| limit required | integer <int64> <= 100 Количество значений на странице. |
| cursor | string Указатель для выборки следующих данных. Если параметр пустой, данных больше нет. |
Array of objects Список товаров. |
{- "cursor": "string",
- "filter": {
- "carriage_id": 0,
- "cutoff_from": "2019-08-24T14:15:22Z",
- "cutoff_to": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0
}, - "limit": 0
}{- "cursor": "string",
- "products": [
- {
- "offer_id": "string",
- "picture_url": "string",
- "posting_numbers": [
- "string"
], - "product_name": "string",
- "quantity": 0,
- "sku": 0
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| cursor | string Указатель для выборки следующих данных. |
required | object Фильтр. |
| limit required | integer <int64> <= 1000 Количество значений на странице. |
| sort_dir | string Enum: "ASC" "DESC" Направление сортировки:
|
| cursor | string Указатель для выборки следующих данных. Если параметр пустой, данных больше нет. |
| cutoff | string <date-time> Время, до которого продавцу нужно собрать заказ. |
Array of objects Список отправлений. |
{- "cursor": "string",
- "filter": {
- "cutoff_from": "2019-08-24T14:15:22Z",
- "cutoff_to": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0
}, - "limit": 0,
- "sort_dir": "ASC"
}{- "cursor": "string",
- "cutoff": "2019-08-24T14:15:22Z",
- "postings": [
- {
- "assembly_code": "string",
- "posting_number": "string",
- "products": [
- {
- "offer_id": "string",
- "picture_url": "string",
- "product_name": "string",
- "quantity": 0,
- "sku": 0
}
]
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Фильтр. |
| limit required | integer <int64> <= 1000 Количество значений на странице. |
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
| sort_dir | string Enum: "ASC" "DESC" Направление сортировки:
|
| has_next | boolean Признак, что в ответе вернули не все товары:
|
Array of objects Список товаров. | |
| products_count | integer <int32> Количество товаров. |
{- "filter": {
- "cutoff_from": "2019-08-24T14:15:22Z",
- "cutoff_to": "2019-08-24T14:15:22Z",
- "delivery_method_id": 0
}, - "limit": 0,
- "offset": 0,
- "sort_dir": "ASC"
}{- "has_next": true,
- "products": [
- {
- "offer_id": "string",
- "picture_url": "string",
- "postings": [
- {
- "posting_number": "string",
- "quantity": 0
}
], - "product_name": "string",
- "quantity": 0,
- "sku": 0
}
], - "products_count": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Координаты адреса склада. |
required | object Информация о методе доставки «Партнёры Ozon». |
| min_order_value | integer <int64> Минимальная стоимость заказа. |
| name required | string <= 100 characters Название склада. |
| phone required | string+7(XXX)XXX-XX-XX Номер телефона склада. |
required | object Расписание работы склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "address_coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "delivery_method": {
- "courier_comment": "string",
- "courier_phones": [
- "string"
], - "cut_in": 15,
- "deliver_to_pvz": true,
- "delivery_costs": {
- "max_amount": 0,
- "min_amount": 0,
- "percent": 0
}, - "name": "string",
- "return_settings": {
- "contact_days": 0,
- "post_office_zipcode": "string",
- "return_method": "UNSPECIFIED",
- "transport_company_name": "string"
}
}, - "min_order_value": 0,
- "name": "string",
- "phone": "string",
- "timetable_warehouse": {
- "holidays": [
- {
- "day": "string",
- "from": "string",
- "to": "string"
}
], - "working_days": [
- {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}
]
}
}{- "operation_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| courier_comment | string <= 3000 characters Комментарий для курьера. |
| courier_phones | Array of strings <= 3 items +7(XXX)XXX-XX-XX Номера телефонов для связи с курьером. |
| cut_in | integer <int64> Enum: 15 30 60 120 180 240 300 360 420 480 Время сборки. |
| deliver_to_pvz | boolean
|
object Расходы на доставку, которые вы готовы оплатить. | |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| name | string <= 100 characters Название метода доставки. |
object Настройки возвратов от покупателей. | |
| warehouse_id required | integer <int64> Идентификатор склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "courier_comment": "string",
- "courier_phones": [
- "string"
], - "cut_in": 15,
- "deliver_to_pvz": true,
- "delivery_costs": {
- "max_amount": 0,
- "min_amount": 0,
- "percent": 0
}, - "delivery_method_id": 0,
- "name": "string",
- "return_settings": {
- "contact_days": 0,
- "post_office_zipcode": "string",
- "return_method": "UNSPECIFIED",
- "transport_company_name": "string"
}, - "warehouse_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
required | object Координаты адреса склада. |
required | object Информация о методе доставки «Вы или сторонняя служба». |
| min_order_value | integer <int64> Минимальная стоимость заказа. |
| name required | string <= 100 characters Название склада. |
| phone required | string+7(XXX)XXX-XX-XX Номер телефона склада. |
required | object Расписание работы склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "address_coordinates": {
- "latitude": 0,
- "longitude": 0
}, - "delivery_method": {
- "courier_cutoff": 5,
- "cut_in": 15,
- "delivery_polygons": [
- {
- "id": 0,
- "time": 15
}
], - "name": "string",
- "return_settings": {
- "contact_days": 0,
- "post_office_zipcode": "string",
- "return_method": "UNSPECIFIED",
- "transport_company_name": "string"
}
}, - "min_order_value": 0,
- "name": "string",
- "phone": "string",
- "timetable_warehouse": {
- "holidays": [
- {
- "day": "string",
- "from": "string",
- "to": "string"
}
], - "working_days": [
- {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}
]
}
}{- "operation_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| courier_cutoff required | integer <int64> Enum: 5 10 15 20 25 30 35 40 45 Скорость отгрузки. |
| cut_in required | integer <int64> Enum: 15 30 60 120 180 240 300 360 420 480 Время сборки. |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| name required | string <= 100 characters Название метода доставки. |
required | object Настройки возвратов от покупателей. |
| warehouse_id required | integer <int64> Идентификатор склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "courier_cutoff": 5,
- "cut_in": 15,
- "delivery_method_id": 0,
- "name": "string",
- "return_settings": {
- "contact_days": 0,
- "post_office_zipcode": "string",
- "return_method": "UNSPECIFIED",
- "transport_company_name": "string"
}, - "warehouse_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| min_order_value | integer <int64> Минимальная стоимость заказа. |
| name | string <= 100 characters Название склада. |
| phone | string+7(XXX)XXX-XX-XX Номер телефона склада. |
object Расписание работы склада. | |
| warehouse_id required | integer <int64> Идентификатор склада. |
| operation_id | string Идентификатор операции. Получите статус операции методом /v1/warehouse/operation/status. |
{- "min_order_value": 0,
- "name": "string",
- "phone": "string",
- "timetable_warehouse": {
- "holidays": [
- {
- "day": "string",
- "from": "string",
- "to": "string"
}
], - "working_days": [
- {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}, - {
- "day": "UNSPECIFIED",
- "from": "string",
- "to": "string"
}
]
}, - "warehouse_id": 0
}{- "operation_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| polygon_id required | integer <int64> Идентификатор полигона. |
| time required | integer <int64> Enum: 15 30 45 60 90 120 150 Время доставки в минутах. |
| warehouse_id required | integer <int64> Идентификатор склада. |
{- "delivery_method_id": 0,
- "polygon_id": 0,
- "time": 15,
- "warehouse_id": 0
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| polygon_id required | integer <int64> Идентификатор полигона. |
| warehouse_id required | integer <int64> Идентификатор склада. |
{- "delivery_method_id": 0,
- "polygon_id": 0,
- "warehouse_id": 0
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| warehouse_id required | integer <int64> Идентификатор склада. |
Array of objects Список полигонов. | |||||||
Array ()
| |||||||
{- "delivery_method_id": 0,
- "warehouse_id": 0
}{- "polygons": [
- {
- "coordinates": "string",
- "polygon_id": 0,
- "time": 0
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| coordinates required | string Новые координаты полигона доставки в формате |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| polygon_id required | integer <int64> Идентификатор полигона. |
| warehouse_id required | integer <int64> Идентификатор склада. |
{- "coordinates": "string",
- "delivery_method_id": 0,
- "polygon_id": 0,
- "warehouse_id": 0
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| current_time required | integer <int64> Enum: 15 30 45 60 90 120 150 Текущее время доставки в минутах. |
| delivery_method_id required | integer <int64> Идентификатор метода доставки. |
| new_time required | integer <int64> Enum: 15 30 45 60 90 120 150 Новое время доставки в минутах. |
| polygon_id required | integer <int64> Идентификатор полигона. |
| warehouse_id required | integer <int64> Идентификатор склада. |
{- "current_time": 15,
- "delivery_method_id": 0,
- "new_time": 15,
- "polygon_id": 0,
- "warehouse_id": 0
}{- "code": 0,
- "details": [
- {
- "typeUrl": "string",
- "value": "string"
}
], - "message": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Список складов. | |||||||||||||||
Array ()
| |||||||||||||||
{- "warehouses": [
- {
- "address_detailing": {
- "city": "string",
- "country": "string",
- "house": "string",
- "region": "string",
- "street": "string",
- "zipcode": "string"
}, - "id": 0,
- "is_bonded": true,
- "name": "string",
- "partner_name": "string",
- "supply_types": [
- 0
], - "timezone_name": "string"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор поставки. |
| bundle_id | string Идентификатор списка провалидированных товаров. |
object Статус отмены. | |
| created_at | string <date-time> Дата создания черновика. |
object Причина отказа. | |
| deleted_at | string <date-time> Дата удаления черновика. |
object Детали доставки. | |
| editable | boolean
|
| id | integer <int64> Идентификатор черновика. |
| is_cancelable | boolean
|
| is_deletable | boolean
|
| is_registration_available | boolean
|
| locked | boolean
|
| package_units_count | integer <int32> Количество грузомест. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| status | string Default: "DRAFT_STATUS_UNSPECIFIED" Enum: "DRAFT_STATUS_UNSPECIFIED" "NEW" "SUPPLY_VARIANT_CONFIRMATION" "SUPPLY_NOT_CONFIRMED" Статус черновика:
|
| supply_id | string Идентификатор поставки. |
| warehouse_id | integer <int64> Идентификатор склада. |
{- "supply_id": "string"
}{- "bundle_id": "string",
- "cancellation_state": {
- "cancellation_error": {
- "error_code": "CODE_UNSPECIFIED",
- "message": "string"
}, - "cancellation_status": "STATUS_UNSPECIFIED"
}, - "created_at": "2019-08-24T14:15:22Z",
- "decline_reason": {
- "failed_sku_ids": [
- "string"
], - "message": "string"
}, - "deleted_at": "2019-08-24T14:15:22Z",
- "delivery_details": {
- "direct_details": {
- "by_seller_details": {
- "driver_name": "string",
- "vehicle_registration_number": "string",
- "vehicle_type": "string"
}, - "by_tpl_details": {
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "timeslot_details": {
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}, - "timeslot_reservation_id": "string"
}
}, - "drop_off_point": {
- "id": 0,
- "province_uuid": "string",
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
}, - "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "supply_type": "SUPPLY_TYPE_UNSPECIFIED"
}, - "editable": true,
- "id": 0,
- "is_cancelable": true,
- "is_deletable": true,
- "is_registration_available": true,
- "locked": true,
- "package_units_count": 0,
- "row_version": 0,
- "status": "DRAFT_STATUS_UNSPECIFIED",
- "supply_id": "string",
- "warehouse_id": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| count | integer <int32> Количество элементов в ответе. |
| last_id | integer <int64> Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| has_next | boolean
|
Array of objects Черновики. | |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
{- "count": 0,
- "last_id": 0
}{- "has_next": true,
- "items": [
- {
- "bundle_id": "string",
- "cancellation_state": {
- "cancellation_error": {
- "error_code": "CODE_UNSPECIFIED",
- "message": "string"
}, - "cancellation_status": "STATUS_UNSPECIFIED"
}, - "created_at": "2019-08-24T14:15:22Z",
- "deleted_at": "2019-08-24T14:15:22Z",
- "delivery_details": {
- "direct_details": {
- "by_seller_details": {
- "driver_name": "string",
- "vehicle_registration_number": "string",
- "vehicle_type": "string"
}, - "by_tpl_details": {
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "timeslot_details": {
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}, - "timeslot_reservation_id": "string"
}
}, - "drop_off_point": {
- "id": 0,
- "province_uuid": "string",
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
}, - "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "supply_type": "SUPPLY_TYPE_UNSPECIFIED"
}, - "editable": true,
- "id": 0,
- "is_cancelable": true,
- "is_deletable": true,
- "locked": true,
- "package_units_count": 0,
- "status": "DRAFT_STATUS_UNSPECIFIED",
- "supply_id": "string",
- "warehouse_id": 0
}
], - "last_id": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| bundle_id | string Идентификатор провалидированного списка товаров. |
object Детали доставки. | |
| package_units_count | integer <int32> Количество грузомест. |
| warehouse_id | integer <int64> Идентификатор склада продавца. |
| draft_id | integer <int64> Идентификатор черновика. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
{- "bundle_id": "string",
- "delivery_details": {
- "driver_name": "string",
- "timeslot_start": "2019-08-24T14:15:22Z",
- "vehicle_number": "string",
- "vehicle_type": "string"
}, - "package_units_count": 0,
- "warehouse_id": 0
}{- "draft_id": 0,
- "row_version": 0,
- "supply_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| driver_name | string ФИО водителя. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
| vehicle_number | string Номер автомобиля. |
| vehicle_type | string Тип автомобиля. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "driver_name": "string",
- "row_version": 0,
- "supply_id": "string",
- "vehicle_number": "string",
- "vehicle_type": "string"
}{- "error": {
- "errors": "ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
| timeslot_start | string <date-time> Начало таймслота. |
| error_reasons | Array of strings Default: "RESERVE_FAILURE_TYPE_UNSPECIFIED" Items Enum: "RESERVE_FAILURE_TYPE_UNSPECIFIED" "REQUEST_VALIDATION" "INVALID_RESERVE" "LOGISTICS_REASON" "SCHEDULE_REASON" "NO_CAPACITY" Причина ошибки:
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "row_version": 0,
- "supply_id": "string",
- "timeslot_start": "2019-08-24T14:15:22Z"
}{- "error_reasons": "RESERVE_FAILURE_TYPE_UNSPECIFIED",
- "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| bundle_id | string Идентификатор провалидированного списка товаров. |
| interval_end | string <date-time> Дата окончания нужного периода доступных таймслотов. |
| interval_start | string <date-time> Дата начала нужного периода доступных таймслотов. |
| warehouse_id | integer <int64> Идентификатор склада продавца. |
| reasons | Array of strings Default: "EMPTY_TIMESLOTS_REASON_UNSPECIFIED" Items Enum: "EMPTY_TIMESLOTS_REASON_UNSPECIFIED" "LOGISTICS_UNKNOWN" "NO_ROUTE" "NO_ROUTE_SCHEDULES" "NO_LOGISTICS_CAPACITY" "SCHEDULE_UNKNOWN" "NOT_ENOUGH_CAPACITY" "NOT_ENOUGH_TRUCKS" "LIMITS_NOT_AVAILABLE" "CROSS_DOCK_RESERVE_MISSING" "SCHEDULE_RESERVE_MISSING" Причины отсутствия таймслотов:
|
Array of objects Список доступных таймслотов. | |
| warehouse_timezone_name | string Часовой пояс склада продавца. |
{- "bundle_id": "string",
- "interval_end": "2019-08-24T14:15:22Z",
- "interval_start": "2019-08-24T14:15:22Z",
- "warehouse_id": 0
}{- "reasons": "EMPTY_TIMESLOTS_REASON_UNSPECIFIED",
- "timeslots": [
- {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
], - "warehouse_timezone_name": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| bundle_id | string Идентификатор провалидированного списка товаров. Чтобы получить, используйте метод /v1/fbp/draft/direct/product/validate. |
object Детали доставки. | |
| package_units_count | integer <int32> Количество единиц упаковки. |
| warehouse_id | integer <int64> Идентификатор склада. |
| draft_id | integer <int64> Идентификатор черновика. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
{- "bundle_id": "string",
- "delivery_details": {
- "timeslot_start": [
- "2019-08-24T14:15:22Z"
]
}, - "package_units_count": 0,
- "warehouse_id": 0
}{- "draft_id": 0,
- "row_version": 0,
- "supply_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_id | string Идентификатор поставки. |
object Статус отмены. | |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "supply_id": "string"
}{- "cancellation_state": {
- "cancellation_error": {
- "error_code": "CODE_UNSPECIFIED",
- "message": "string"
}, - "cancellation_status": "STATUS_UNSPECIFIED"
}, - "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Идентификаторы товаров в системе Ozon — SKU. | |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Подтверждённые товары. | |
| bundle_generated | boolean
|
| bundle_id | string Идентификатор провалидированного списка товаров. |
Array of objects Отклонённые товары. |
{- "skus": [
- {
- "count": 0,
- "sku": 0
}
], - "warehouse_id": 0
}{- "approved_items": [
- {
- "barcode": "string",
- "icon_name": "string",
- "name": "string",
- "offer_id": "string",
- "quantity": 0,
- "sku": 0,
- "volume": 0
}
], - "bundle_generated": true,
- "bundle_id": "string",
- "rejected_items": [
- {
- "barcode": "string",
- "icon_name": "string",
- "name": "string",
- "offer_id": "string",
- "quantity": 0,
- "rejection_reasons": "BUNDLE_ITEM_ERROR_UNSPECIFIED",
- "sku": 0,
- "volume": 0
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
object Ошибка. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "row_version": 0,
- "supply_id": "string"
}{- "error": {
- "bundle_errors": [
- {
- "errors": "BUNDLE_ITEM_ERROR_UNSPECIFIED",
- "sku": 0
}
], - "order_error": "ORDER_ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| bundle_id | string Идентификатор комплекта. |
object Детали доставки. | |
| package_units_count | integer <int32> Количество грузомест. |
| warehouse_id | integer <int64> Идентификатор склада. |
| draft_id | integer <int64> Идентификатор черновика. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
{- "bundle_id": "string",
- "delivery_details": {
- "timeslot_start": "2019-08-24T14:15:22Z",
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "package_units_count": 0,
- "warehouse_id": 0
}{- "draft_id": 0,
- "row_version": 0,
- "supply_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
| tracking_number | string Трек-номер отправления. |
| transport_company_name | string Название транспортной компании. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "row_version": 0,
- "supply_id": "string",
- "tracking_number": "string",
- "transport_company_name": "string"
}{- "errors": [
- "ERROR_TYPE_UNSPECIFIED"
], - "is_error": "true",
- "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| bundle_id | string Идентификатор провалидированного списка товаров. |
object Детали доставки. | |
| package_units_count | integer <int32> Количество грузомест. |
| warehouse_id | integer <int64> Идентификатор склада продавца. |
| draft_id | integer <int64> Идентификатор черновика. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
{- "bundle_id": "string",
- "delivery_details": {
- "drop_off_date": "string",
- "drop_off_point_id": 0,
- "drop_off_province_uuid": "string"
}, - "package_units_count": 0,
- "warehouse_id": 0
}{- "draft_id": 0,
- "row_version": 0,
- "supply_id": "string"
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_id | string Идентификатор заявки на поставку. |
object Статус отмены. | |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "supply_id": "string"
}{- "cancellation_state": {
- "cancellation_error": {
- "error_code": "NO_RESPONSE_FROM_3PF",
- "message": "string"
}, - "cancellation_status": "CONFIRMATION"
}, - "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| drop_off_date | string Дата доставки. |
| drop_off_point_id | integer <int64> Идентификатор drop-off пункта. |
| drop_off_province_uuid | string Уникальный идентификатор провинции. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "drop_off_date": "string",
- "drop_off_point_id": 0,
- "drop_off_province_uuid": "string",
- "row_version": 0,
- "supply_id": "string"
}{- "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
object Ошибка. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "row_version": 0,
- "supply_id": "string"
}{- "error": {
- "bundle_errors": [
- {
- "errors": [
- "BUNDLE_ITEM_ERROR_UNSPECIFIED"
], - "sku": 0
}
], - "order_error": "ORDER_ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Список провинций. | |||||||
Array ()
| |||||||
{- "warehouse_id": 0
}{- "provinces": [
- {
- "name": "string",
- "points_count": 0,
- "province_uuid": "string"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| next_page_number | integer <int32> Следующий номер страницы. |
| page_size | integer <int32> Количество элементов на странице. |
| province_uuid | string Уникальный идентификатор провинции. |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Список drop-off пунктов. | |||||||||||
Array ()
| |||||||||||
{- "next_page_number": 0,
- "page_size": 0,
- "province_uuid": "string",
- "warehouse_id": 0
}{- "drop_off_points": [
- {
- "city": "string",
- "drop_off_point_id": 0,
- "nearest_drop_off_date": "2019-08-24T14:15:22Z",
- "point_address": "string",
- "province_uuid": "string"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| drop_off_point_id | integer <int64> Идентификатор drop-off пункта. |
| province_uuid | string Уникальный идентификатор провинции. |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Расписание работы drop-off пункта. | |||||
Array ()
| |||||
{- "drop_off_point_id": 0,
- "province_uuid": "string",
- "warehouse_id": 0
}{- "calendar": [
- {
- "calendar_item": {
- "break_hours": {
- "timeslot_end": "string",
- "timeslot_start": "string"
}, - "is_holiday": true,
- "opening_hours": {
- "timeslot_end": "string",
- "timeslot_start": "string"
}
}, - "day_of_week": "DAY_OF_WEEK_UNSPECIFIED"
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
Array of objects Идентификаторы товаров в системе Ozon — SKU. | |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Принятые товары. | |
| bundle_generated | boolean
|
| bundle_id | string Идентификатор провалидированного списка товаров. |
Array of objects Отклонённые товары. |
{- "skus": [
- {
- "count": 0,
- "sku": 0
}
], - "warehouse_id": 0
}{- "approved_items": [
- {
- "barcode": "string",
- "icon_name": "string",
- "name": "string",
- "offer_id": "string",
- "quantity": 0,
- "sku": 0,
- "volume": 0
}
], - "bundle_generated": true,
- "bundle_id": "string",
- "rejected_items": [
- {
- "barcode": "string",
- "icon_name": "string",
- "name": "string",
- "offer_id": "string",
- "quantity": 0,
- "rejection_reasons": [
- "BUNDLE_ITEM_ERROR_UNSPECIFIED"
], - "sku": 0,
- "volume": 0
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| bundle_id | string Идентификатор состава поставки. |
object Детали доставки. | |
| package_units_count | integer <int32> Количество грузомест. |
| warehouse_id | integer <int64> Идентификатор склада. |
| draft_id | integer <int64> Идентификатор черновика заявки на поставку. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
{- "bundle_id": "string",
- "delivery_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "package_units_count": 0,
- "warehouse_id": 0
}{- "draft_id": 0,
- "row_version": 0,
- "supply_id": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор поставки. |
object Статус отмены. | |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "supply_id": "string"
}{- "cancellation_state": {
- "cancellation_error": {
- "error_code": "CODE_UNSPECIFIED",
- "message": "string"
}, - "cancellation_status": "STATUS_UNSPECIFIED"
}, - "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
object Детали доставки. | |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "row_version": 0,
- "supply_id": "string"
}{- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
Array of objects Список идентификаторов товаров — SKU. | |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Подтверждённые товары. | |
| bundle_generated | boolean
|
| bundle_id | string Идентификатор провалидированного списка товаров. |
Array of objects Отклонённые товары. |
{- "skus": [
- {
- "count": 0,
- "sku": 0
}
], - "warehouse_id": 0
}{- "approved_items": [
- {
- "barcode": "string",
- "icon_name": "string",
- "name": "string",
- "offer_id": "string",
- "quantity": 0,
- "sku": 0,
- "volume": 0
}
], - "bundle_generated": true,
- "bundle_id": "string",
- "rejected_items": [
- {
- "barcode": "string",
- "icon_name": "string",
- "name": "string",
- "offer_id": "string",
- "quantity": 0,
- "rejection_reasons": [
- "BUNDLE_ITEM_ERROR_UNSPECIFIED"
], - "sku": 0,
- "volume": 0
}
]
}Вы можете оставить обратную связь о работе метода в комментариях в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
object Ошибка. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "row_version": 0,
- "supply_id": "string"
}{- "error": {
- "bundle_errors": [
- {
- "errors": [
- "BUNDLE_ITEM_ERROR_UNSPECIFIED"
], - "sku": 0
}
], - "order_error": "ORDER_ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор заявки на поставку. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "supply_id": "string"
}{- "error": {
- "order_errors": [
- "ERROR_TYPE_UNSPECIFIED"
]
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| driver_name | string ФИО водителя. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
| vehicle_number | string Номер автомобиля. |
| vehicle_type | string Тип автомобиля. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "driver_name": "string",
- "row_version": 0,
- "supply_id": "string",
- "vehicle_number": "string",
- "vehicle_type": "string"
}{- "error": {
- "order_errors": "ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор заявки на поставку. |
| timeslot_start | string <date-time> Начало таймслота. |
| error_reasons | Array of strings Items Enum: "RESERVE_FAILURE_TYPE_UNSPECIFIED" "REQUEST_VALIDATION" "INVALID_RESERVE" "LOGISTICS_REASON" "SCHEDULE_REASON" Причина ошибки:
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "row_version": 0,
- "supply_id": "string",
- "timeslot_start": "2019-08-24T14:15:22Z"
}{- "error_reasons": [
- "RESERVE_FAILURE_TYPE_UNSPECIFIED"
], - "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| interval_end | string <date-time> Дата окончания нужного периода доступных таймслотов. |
| interval_start | string <date-time> Дата начала нужного периода доступных таймслотов. |
| supply_id | string Идентификатор заявки на поставку. |
| reasons | Array of strings Items Enum: "EMPTY_TIMESLOTS_REASON_UNSPECIFIED" "LOGISTICS_UNKNOWN" "NO_ROUTE" "NO_ROUTE_SCHEDULES" "NO_LOGISTICS_CAPACITY" "SCHEDULE_UNKNOWN" "NOT_ENOUGH_CAPACITY" "NOT_ENOUGH_TRUCKS" "LIMITS_NOT_AVAILABLE" "CROSS_DOCK_RESERVE_MISSING" "SCHEDULE_RESERVE_MISSING" Причины отсутствия таймслотов:
|
Array of objects Список доступных таймслотов. | |
| warehouse_timezone_name | string Часовой пояс склада продавца. |
{- "interval_end": "2019-08-24T14:15:22Z",
- "interval_start": "2019-08-24T14:15:22Z",
- "supply_id": "string"
}{- "reasons": [
- "EMPTY_TIMESLOTS_REASON_UNSPECIFIED"
], - "timeslots": [
- {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
], - "warehouse_timezone_name": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| supply_id | string Идентификатор поставки. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "supply_id": "string"
}{- "error": {
- "order_errors": [
- "ERROR_TYPE_UNSPECIFIED"
]
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| drop_off_date | string Дата прибытия поставки на drop-off пункт. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "drop_off_date": "string",
- "row_version": 0,
- "supply_id": "string"
}{- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| drop_off_point_id | integer <int64> Идентификатор drop-off пункта. |
| province_uuid | string Уникальный идентификатор провинции. |
| warehouse_id | integer <int64> Идентификатор склада. |
Array of objects Информация о графике работы drop-off пункта. | |||||
Array ()
| |||||
{- "drop_off_point_id": 0,
- "province_uuid": "string",
- "warehouse_id": 0
}{- "calendar": [
- {
- "calendar_item": {
- "break_hours": {
- "timeslot_end": "string",
- "timeslot_start": "string"
}, - "is_holiday": true,
- "opening_hours": {
- "timeslot_end": "string",
- "timeslot_start": "string"
}
}, - "day_of_week": "DAY_OF_WEEK_UNSPECIFIED"
}
]
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор поставки. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "supply_id": "string"
}{- "error": {
- "order_errors": "ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
object Детали отправителя. | |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| supply_id | string Идентификатор поставки. |
object Информация об ошибке. | |
| is_error | boolean
|
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
{- "pickup_details": {
- "sender_name": "string",
- "sender_phone": "string"
}, - "row_version": 0,
- "supply_id": "string"
}{- "error": {
- "order_errors": "ERROR_TYPE_UNSPECIFIED"
}, - "is_error": true,
- "row_version": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор поставки. |
| errors | Array of strings Default: "CREATE_ACT_ERROR_REASON_UNSPECIFIED" Items Enum: "CREATE_ACT_ERROR_REASON_UNSPECIFIED" "INVALID_ORDER_TYPE" Причина ошибки:
|
| file_uuid | string Идентификатор акта приёмки. |
| is_success | boolean
|
{- "supply_id": "string"
}{- "errors": [
- "CREATE_ACT_ERROR_REASON_UNSPECIFIED"
], - "file_uuid": "string",
- "is_success": true
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| file_uuid | string Идентификатор акта приёмки. |
| cdn_url | string Ссылка на акт приёмки. |
| error | string Default: "ERROR_REASON_UNSPECIFIED" Enum: "ERROR_REASON_UNSPECIFIED" "INVALID_COMPANY" "FILE_NOT_FOUND" "GENERATE_TIMEOUT_REACHED" "GENERATION_ERROR" Ошибка генерации:
|
| status | string Default: "STATUS_UNSPECIFIED" Enum: "STATUS_UNSPECIFIED" "NOT_EXIST" "PROCESSING" "EXIST" "ERROR" Статус генерации:
|
{- "file_uuid": "string"
}{- "cdn_url": "string",
- "error": "ERROR_REASON_UNSPECIFIED",
- "status": "STATUS_UNSPECIFIED"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор поставки. |
| code | string Идентификатор транспортной накладной. |
{- "supply_id": "string"
}{- "code": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| code | string Идентификатор транспортной накладной. |
| supply_id | string Идентификатор поставки. |
| error_message | string Описание ошибки. |
| label_url | string Ссылка на этикетки для поставки. |
| state | string Default: "STATE_TYPE_UNSPECIFIED" Enum: "STATE_TYPE_UNSPECIFIED" "IN_PROGRESS" "FINISHED" "FAILED" Статус генерации:
|
{- "code": "string",
- "supply_id": "string"
}{- "error_message": "string",
- "label_url": "string",
- "state": "STATE_TYPE_UNSPECIFIED"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id required | string Идентификатор поставки. |
| act_file_uuid | string Идентификатор акта приёмки. |
| bundle_id | string Идентификатор провалидированного списка товаров. |
object Сводная информация по товарам в поставке. | |
| business_flow_type_id | integer <int64> Идентификатор типа поставки. |
| created_date | string <date-time> Дата и время создания заявки на поставку. |
object Причина отклонения поставки. | |
object Детали доставки. | |
| has_act | boolean
|
| has_label | boolean
|
| id | integer <int64> Номер записи в архиве. |
| order_draft_id | integer <int64> Идентификатор черновика поставки. |
| order_number | string Идентификатор завершённой поставки. |
| package_units_count | integer <int32> Количество грузомест. |
| receive_date | string <date-time> Дата и время принятия поставки. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| status | string Default: "ARCHIVE_STATUS_UNSPECIFIED" Enum: "ARCHIVE_STATUS_UNSPECIFIED" "COMPLETED" "REJECTED_AT_SUPPLY_WAREHOUSE" "CANCELLED_BY_SELLER" Статус завершённой поставки:
|
| supply_id | string Идентификатор поставки. |
| warehouse_id | integer <int64> Идентификатор склада. |
{- "supply_id": "string"
}{- "act_file_uuid": "string",
- "bundle_id": "string",
- "bundle_sku_summary": {
- "rounded_total_volume_in_litres": 0,
- "total_items_count": 0,
- "total_quantity": 0
}, - "business_flow_type_id": 0,
- "created_date": "2019-08-24T14:15:22Z",
- "decline_reason": {
- "code": "DECLINE_REASON_CODE_UNSPECIFIED",
- "message": "string"
}, - "delivery_details": {
- "direct_details": {
- "by_seller_details": {
- "driver_name": "string",
- "vehicle_registration_number": "string",
- "vehicle_type": "string"
}, - "by_tpl_details": {
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "timeslot_details": {
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}, - "timeslot_reservation_id": "string"
}
}, - "drop_off_point": {
- "id": 0,
- "province_uuid": "string",
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
}, - "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "supply_type": "SUPPLY_TYPE_UNSPECIFIED"
}, - "has_act": true,
- "has_label": true,
- "id": 0,
- "order_draft_id": 0,
- "order_number": "string",
- "package_units_count": 0,
- "receive_date": "2019-08-24T14:15:22Z",
- "row_version": 0,
- "status": "ARCHIVE_STATUS_UNSPECIFIED",
- "supply_id": "string",
- "warehouse_id": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| count required | string <int32> Количество элементов в ответе. |
| last_id | string <int64> Идентификатор последнего значения на странице. Оставьте это поле пустым при выполнении первого запроса. Чтобы получить следующие значения, укажите |
| has_next | boolean
|
Array of objects Завершённые поставки. | |
| last_id | integer <int64> Идентификатор последнего значения на странице. |
{- "count": "string",
- "last_id": "string"
}{- "has_next": true,
- "items": [
- {
- "act_file_uuid": "string",
- "bundle_id": "string",
- "bundle_sku_summary": {
- "rounded_total_volume_in_litres": 0,
- "total_items_count": 0,
- "total_quantity": 0
}, - "created_date": "2019-08-24T14:15:22Z",
- "decline_reason": {
- "code": "DECLINE_REASON_CODE_UNSPECIFIED",
- "message": "string"
}, - "delivery_details": {
- "direct_details": {
- "by_seller_details": {
- "driver_name": "string",
- "vehicle_registration_number": "string",
- "vehicle_type": "string"
}, - "by_tpl_details": {
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "timeslot_details": {
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}, - "timeslot_reservation_id": "string"
}
}, - "drop_off_point": {
- "id": 0,
- "province_uuid": "string",
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
}, - "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "supply_type": "SUPPLY_TYPE_UNSPECIFIED"
}, - "external_order_id": "string",
- "has_act": true,
- "has_label": true,
- "order_draft_id": 0,
- "package_units_count": 0,
- "receive_date": "2019-08-24T14:15:22Z",
- "row_version": 0,
- "status": "ARCHIVE_STATUS_UNSPECIFIED",
- "supply_id": "string",
- "warehouse_id": 0,
- "whc_order_id": 0
}
], - "last_id": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id required | string Идентификатор поставки. |
| code | string Идентификатор задания на генерацию этикеток. |
{- "supply_id": "string"
}{- "code": "string"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| code required | string Идентификатор задания на генерацию этикеток. |
| supply_id required | string Идентификатор поставки. |
| label_url | string Ссылка на этикетки для поставки. |
| state | string Default: "UNSPECIFIED" Enum: "UNSPECIFIED" "IN_PROGRESS" "FINISHED" "FAILED" Статус задания на генерацию этикеток:
|
{- "code": "string",
- "supply_id": "string"
}{- "label_url": "string",
- "state": "UNSPECIFIED"
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| supply_id | string Идентификатор поставки. |
| attention_reasons | Array of strings Default: "ORDER_ATTENTION_TYPE_UNSPECIFIED" Items Enum: "ORDER_ATTENTION_TYPE_UNSPECIFIED" "OLD" "TIME_SLOT_EXPIRED" Причины предупреждения:
|
| bundle_uuid | string Идентификатор товарного состава. |
| can_be_cancelled | boolean
|
object Статус отмены. | |
| created_date | string <date-time> Дата создания поставки. |
object Детали доставки. | |
| draft_id | integer <int64> Идентификатор черновика. |
| has_consignment_note | boolean
|
| has_label | boolean
|
| id | integer <int64> Идентификатор заявки на поставку. |
| locked | boolean
|
| order_number | string Номер поставки. |
| package_units_count | integer <int32> Количество грузомест. |
| receive_date | string <date-time> Дата и время принятия поставки. |
| row_version | integer <int64> Идентификатор актуальной версии черновика. |
| status | string Default: "ORDER_STATUS_UNSPECIFIED" Enum: "ORDER_STATUS_UNSPECIFIED" "READY_TO_SUPPLY" "FILLING_DELIVERY_DETAILS" "COURIER_ASSIGNED" "COURIER_PICKED_UP" "ACCEPTANCE_AT_DROP_OFF_POINT" "IN_TRANSIT_TO_STORAGE_WAREHOUSE" "ACCEPTANCE_AT_STORAGE_WAREHOUSE" "CANCELLED" Статус заказа:
|
| supply_id | string Идентификатор поставки. |
| warehouse_id | integer <int64> Идентификатор склада. |
{- "supply_id": "string"
}{- "attention_reasons": "ORDER_ATTENTION_TYPE_UNSPECIFIED",
- "bundle_uuid": "string",
- "can_be_cancelled": true,
- "cancellation_state": {
- "cancellation_error": {
- "error_code": "CODE_UNSPECIFIED",
- "message": "string"
}, - "cancellation_status": "STATUS_UNSPECIFIED"
}, - "created_date": "2019-08-24T14:15:22Z",
- "delivery_details": {
- "direct_details": {
- "by_seller_details": {
- "driver_name": "string",
- "vehicle_registration_number": "string",
- "vehicle_type": "string"
}, - "by_tpl_details": {
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "timeslot_details": {
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}, - "timeslot_reservation_id": "string"
}
}, - "drop_off_point": {
- "id": 0,
- "province_uuid": "string",
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
}, - "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "supply_type": "SUPPLY_TYPE_UNSPECIFIED"
}, - "draft_id": 0,
- "has_consignment_note": true,
- "has_label": true,
- "id": 0,
- "locked": true,
- "order_number": "string",
- "package_units_count": 0,
- "receive_date": "2019-08-24T14:15:22Z",
- "row_version": 0,
- "status": "ORDER_STATUS_UNSPECIFIED",
- "supply_id": "string",
- "warehouse_id": 0
}Вы можете оставить обратную связь по этому методу в комментариях к обсуждению в сообществе разработчиков Ozon for dev.
| count | integer <int32> Количество поставок в ответе. |
| last_id | integer <int64> Идентификатор последней поставки на странице. Для первого запроса оставьте это поле пустым. Чтобы получить следующие значения, укажите |
| has_next | boolean
|
Array of objects Поставки. | |
| last_id | integer <int64> Идентификатор последней поставки на странице. |
{- "count": 0,
- "last_id": 0
}{- "has_next": true,
- "items": [
- {
- "attention_reasons": "ORDER_ATTENTION_TYPE_UNSPECIFIED",
- "bundle_summary": {
- "rounded_total_volume_in_litres": 0,
- "total_item_count": 0,
- "total_quantity": 0
}, - "can_be_cancelled": true,
- "cancellation_state": {
- "cancellation_error": {
- "error_code": "CODE_UNSPECIFIED",
- "message": "string"
}, - "cancellation_status": "STATUS_UNSPECIFIED"
}, - "created_date": "2019-08-24T14:15:22Z",
- "delivery_details": {
- "direct_details": {
- "by_seller_details": {
- "driver_name": "string",
- "vehicle_registration_number": "string",
- "vehicle_type": "string"
}, - "by_tpl_details": {
- "tracking_number": "string",
- "transport_company_name": "string"
}, - "timeslot_details": {
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}, - "timeslot_reservation_id": "string"
}
}, - "drop_off_point": {
- "id": 0,
- "province_uuid": "string",
- "timeslot": {
- "timeslot_end": "2019-08-24T14:15:22Z",
- "timeslot_start": "2019-08-24T14:15:22Z"
}
}, - "pickup_details": {
- "address": "string",
- "comment": "string",
- "date": "2019-08-24T14:15:22Z",
- "sender_name": "string",
- "sender_phone": "string"
}, - "supply_type": "SUPPLY_TYPE_UNSPECIFIED"
}, - "has_consignment_note": true,
- "has_label": true,
- "id": 0,
- "locked": true,
- "order_number": "string",
- "package_units_count": 0,
- "receive_date": "2019-08-24T14:15:22Z",
- "status": "ORDER_STATUS_UNSPECIFIED",
- "supply_id": "string",
- "warehouse_id": 0
}
], - "last_id": 0
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Отправляет сообщение в существующий чат по его идентификатору.
Получите список чатов с покупателем chats.chat.chat_type="Buyer_Seller" в ответе метода /v3/chat/list.
Для отправлений:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| text required | string Текст сообщения в формате plain text от 1 до 1000 символов. |
| result | string Результат обработки запроса. |
{- "chat_id": "99feb3fc-a474-469f-95d5-268b470cc607",
- "text": "test"
}{- "result": "success"
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Создает новый чат с покупателем по отправлению. Например, чтобы уточнить адрес или модель товара.
Для отправлений:
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| posting_number required | string Идентификатор отправления. |
object Результат работы метода. | |||
| |||
{- "posting_number": "47873153-0052-1"
}{- "result": {
- "chat_id": "5969c331-2e64-44b7-8a0e-ff9526762c62"
}
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Возвращает историю сообщений чата. По умолчанию от самого нового сообщения к старым.
Получите список чатов с покупателем chats.chat.chat_type="Buyer_Seller" в ответе метода /v3/chat/list.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| direction | string Направление сортировки сообщений:
Значение по умолчанию — |
object Фильтр по сообщениям. | |
| from_message_id | integer <uint64> Идентификатор сообщения, с которого нужно начать вывод истории чата. По умолчанию — последнее видимое сообщение. Параметр |
| limit | integer <int64> Количество сообщений в ответе. По умолчанию — 50. Максимальное значение — 1000. |
| has_next | boolean Признак, что в ответе вернули не все сообщения. |
Array of objects Массив сообщений, отсортированный в соответствии с параметром |
{- "chat_id": "18b8e1f9-4ae7-461c-84ea-8e1f54d1a45e",
- "direction": "Forward",
- "filter": {
- "message_ids": [
- "3000000300211559667"
]
}, - "from_message_id": 3000000000118032000,
- "limit": 1
}{- "has_next": true,
- "messages": [
- {
- "context": {
- "order_number": "123456789",
- "sku": "987654321"
}, - "created_at": "2019-08-24T14:15:22Z",
- "data": [
- "Здравствуйте, у меня вопрос по вашему товару \"Стекло защитное для смартфонов\", артикул 11223. Подойдет ли он на данную [ модель ](https://www.ozon.ru/product/smartfon-samsung-galaxy-a03s-4-64-gb-chernyy) телефона?"
], - "is_image": true,
- "is_read": true,
- "message_id": "3000000000817031942",
- "moderate_image_status": "SUCCESS",
- "user": {
- "id": "115568",
- "type": "Сustomer"
}
}
]
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Метод для отметки выбранного сообщения и сообщений до него прочитанными.
Получите список чатов с покупателем chats.chat.chat_type="Buyer_Seller" в ответе метода /v3/chat/list.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| chat_id required | string Идентификатор чата. |
| from_message_id | integer <uint64> Идентификатор сообщения. |
| unread_count | integer <int64> Количество непрочитанных сообщений в чате. |
{- "chat_id": "99feb3fc-a474-469f-95d5-268b470cc607",
- "from_message_id": 3000000000118032000
}{- "unread_count": 0
}Уĸажите период и метриĸи, ĸоторые нужно посчитать. В ответе будет аналитиĸа, сгруппированная по параметру dimensions.
Для продавцов без подписки Premium Plus:
Для продавцов с подпиской Premium Plus или Premium Pro ограничений нет.
Метод можно использовать не больше 1 раза в минуту. Соответствует разделу Аналитика → Графики в личном кабинете.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date_from required | string Дата, с которой будут данные в отчёте. Если у вас нет Premium-подписки, укажите дату в пределах последних трёх месяцев. |
| date_to required | string Дата, по которую будут данные в отчёте. |
| dimension required | Array of strings Группировка данных в отчёте. Способы группировки, доступные всем продавцам:
Способы группировки, доступные только продавцам с подпиской Premium Plus:
|
Array of objects Фильтры. | |
| limit required | integer <int64> Количество значений в ответе:
|
| metrics required | Array of strings Укажите до 14 метрик. Если их будет больше, вы получите ошибку с кодом Список метриĸ, по ĸоторым будет сформирован отчёт. Метрики, доступные всем продавцам:
Метрики, доступные только продавцам с подпиской Premium Plus:
|
| offset | integer <int64> Количество элементов, которое будет пропущено в ответе. Например, если |
Array of objects Настройки сортировки отчёта. |
object Результаты запроса. | |||||
| |||||
| timestamp | string Время создания отчёта. | ||||
{- "date_from": "2020-09-01",
- "date_to": "2021-10-15",
- "metrics": [
- "hits_view_search"
], - "dimension": [
- "sku",
- "day"
], - "filters": [ ],
- "sort": [
- {
- "key": "hits_view_search",
- "order": "DESC"
}
], - "limit": 1000,
- "offset": 0
}{- "result": {
- "data": [ ],
- "totals": [
- 0
]
}, - "timestamp": "2021-11-25 15:19:21"
}Используйте метод, чтобы получить данные о запросах ваших товаров. Полная аналитика доступна с подпиской Premium, Premium Plus или Premium Pro. Без подписки вы можете посмотреть часть показателей. Метод аналогичен вкладке Товары в поиске → Запросы моего товара в личном кабинете.
Аналитику по запросам можно проверить за определённые даты. Для этого укажите интервал в полях date_from и date_to. Данные за последний месяц доступны в любом интервале, кроме трёх дней от текущей даты — в эти дни происходит расчёт. Аналитика за даты позже, чем месяц назад, доступна только с подпиской Premium, Premium Plus или Premium Pro и только по неделям — в запросе укажите параметр date_from.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date_from required | string <date-time> Дата начала формирования аналитики. |
| date_to | string <date-time> Дата окончания формирования аналитики. |
| page | integer <int32> >= 0 Индекс страницы, которую возвращает запрос. |
| page_size required | integer <int32> <= 1000 Количество элементов на странице. |
| skus required | Array of strings <int64> Список SKU, идентификаторов товара в системе Ozon. По ним вернётся аналитика по запросам. Максимум — 1000 SKU. |
| sort_by | string Default: "BY_SEARCHES" Enum: "BY_SEARCHES" "BY_VIEWS" "BY_POSITION" "BY_CONVERSION" "BY_GMV" Параметр, по которому товары будут отсортированы. Возможные значения:
|
| sort_dir | string Default: "DESCENDING" Enum: "DESCENDING" "ASCENDING" Направление сортировки:
|
object Период, за который формируется аналитика. | |
Array of objects Список товаров. | |
| page_count | integer <int64> Количество страниц. |
| total | integer <int64> Общее количество запросов. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "page": 0,
- "page_size": 1000,
- "skus": [
- "string"
], - "sort_by": "BY_SEARCHES",
- "sort_dir": "DESCENDING"
}{- "analytics_period": {
- "date_from": "string",
- "date_to": "string"
}, - "items": [
- {
- "category": "string",
- "currency": "string",
- "gmv": 0,
- "name": "string",
- "offer_id": "string",
- "position": 0,
- "sku": 0,
- "unique_search_users": 0,
- "unique_view_users": 0,
- "view_conversion": 0
}
], - "page_count": 0,
- "total": 0
}Используйте метод, чтобы получить данные по запросам на конкретный товар. Полная аналитика доступна с подпиской Premium, Premium Plus или Premium Pro. Без подписки вы можете посмотреть часть показателей. Метод аналогичен просмотру данных по товару на вкладке Товары в поиске → Запросы моего товара в личном кабинете.
Аналитику по запросам можно проверить за определённые даты. Для этого укажите интервал в полях date_from и date_to. Данные за последний месяц доступны в любом интервале, кроме трёх дней от текущей даты — в эти дни происходит расчёт. Аналитика за даты позже, чем месяц назад, доступна только с подпиской Premium, Premium Plus или Premium Pro и только по неделям — в запросе укажите параметр date_from.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| date_from required | string <date-time> Дата начала формирования аналитики. |
| date_to | string <date-time> Дата окончания формирования аналитики. |
| limit_by_sku required | integer <int32> Лимит числа запросов по одному SKU. Максимум — 15 запросов. |
| page | integer <int32> Номер страницы, возвращаемой в запросе. Минимум — 0. |
| page_size required | integer <int32> Количество элементов на странице. Максимум — 100. |
| skus required | Array of strings <int64> Список SKU, идентификаторов товара в системе Ozon. По ним вернётся аналитика по запросам. Максимум — 1000 SKU. |
| sort_by | string Default: "BY_SEARCHES" Enum: "BY_SEARCHES" "BY_VIEWS" "BY_POSITION" "BY_CONVERSION" "BY_GMV" Параметр, по которому товары будут отсортированы. Возможные значения:
Сортировка по параметрам |
| sort_dir | string Default: "DESCENDING" Enum: "DESCENDING" "ASCENDING" Направление сортировки:
|
object Период, за который формируется аналитика. | |
| page_count | integer <int64> Количество страниц. |
Array of objects Список запросов. | |
| total | integer <int64> Общее количество запросов. |
{- "date_from": "2019-08-24T14:15:22Z",
- "date_to": "2019-08-24T14:15:22Z",
- "limit_by_sku": 0,
- "page": 1,
- "page_size": 1000,
- "skus": [
- "string"
], - "sort_by": "BY_SEARCHES",
- "sort_dir": "DESCENDING"
}{- "analytics_period": {
- "date_from": "string",
- "date_to": "string"
}, - "page_count": 0,
- "queries": [
- {
- "currency": "string",
- "gmv": 0,
- "order_count": 0,
- "position": 0,
- "query": "string",
- "query_index": 0,
- "sku": 0,
- "unique_search_users": 0,
- "unique_view_users": 0,
- "view_conversion": 0
}
], - "total": 0
}Доступно для продавцов с подпиской Premium Plus или Premium Pro.
Возвращает данные о суммах реализации из отчёта о реализации товаров за день. Отмены и невыкупы не включаются. Данные доступны не более чем за 32 календарных дня от текущей даты.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| day required | integer <int32> День. |
| month required | integer <int32> Месяц. |
| year required | integer <int32> Год. |
Array of objects Таблица отчёта. | |||||||||||||
Array ()
| |||||||||||||
{- "day": 0,
- "month": 0,
- "year": 0
}{- "rows": [
- {
- "commission_ratio": 0,
- "delivery_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "item": {
- "barcode": "string",
- "name": "string",
- "offer_id": "string",
- "sku": 0
}, - "return_commission": {
- "amount": 0,
- "bonus": 0,
- "commission": 0,
- "compensation": 0,
- "price_per_instance": 0,
- "quantity": 0,
- "standard_fee": 0,
- "bank_coinvestment": 0,
- "stars": 0,
- "pick_up_point_coinvestment": 0,
- "total": 0
}, - "rowNumber": 0,
- "seller_price_per_instance": 0
}
]
}Доступно для продавцов с подпиской Premium Pro.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | string <int64> <= 50 Количество значений на странице. |
| offset required | string <int64> <= 50 Количество элементов, которое будет пропущено в ответе. |
| sort_by | string Default: "SORT_BY_UNSPECIFIED" Enum: "SORT_BY_UNSPECIFIED" "CLIENT_COUNT" "ADD_TO_CART" "CONVERSION_TO_CART" "AVG_PRICE" Параметр, по которому сортируются поисковые запросы:
|
| sort_dir | string Default: "SORT_DIR_UNSPECIFIED" Enum: "SORT_DIR_UNSPECIFIED" "ASC" "DESC" Направление сортировки:
|
| text required | string Поиск по тексту. |
| offset | string <int64> Количество поисковых запросов на странице. |
Array of objects Информация о поисковых запросах. | |
| total | string <int64> Общее количество поисковых запросов. |
{- "limit": "50",
- "offset": "0",
- "sort_by": "CLIENT_COUNT",
- "sort_dir": "ASC",
- "text": "string"
}{- "search_queries": [
- {
- "avg_price": 3786.6,
- "conversion_to_cart": 0.163,
- "client_count": 165418,
- "items_views": 140.828,
- "query": "куртка женская демисезон",
- "add_to_cart": 26977,
- "sellers_count": 63.833
}, - {
- "avg_price": 3786.6,
- "conversion_to_cart": 0.163,
- "client_count": 165418,
- "items_views": 140.828,
- "query": "куртка женская демисезон",
- "add_to_cart": 26977,
- "sellers_count": 63.833
}
], - "offset": "string",
- "total": "string"
}Доступно для продавцов с подпиской Premium Pro.
| Client-Id required | string Идентификатор клиента. |
| Api-Key required | string API-ключ. |
| limit required | string <int64> <= 50 Количество значений на странице. |
| offset required | string <int64> <= 1000 Количество элементов, которое будет пропущено в ответе. |
| offset | string <int64> Количество поисковых запросов на странице. |
Array of objects Информация о поисковых запросах. | |
| total | string <int64> Общее количество поисковых запросов. |
{- "limit": "50",
- "offset": "0"
}{- "search_queries": [
- {
- "avg_price": 3786.6,
- "conversion_to_cart": 0.163,
- "client_count": 165418,
- "items_views": 140.828,
- "query": "куртка женская демисезон",
- "add_to_cart": 26977,
- "sellers_count": 63.833
}
], - "offset": "1",
- "total": "1"
}Методы в разделе Ozon Логистика работают только через OAuth-токен в частном или публичном приложении.
Возвращает возможные причины отмены отправлений и заказов.
Array of objects Информация о причинах отмены. | |||||
Array ()
| |||||
{- "reasons": [
- {
- "id": 0,
- "name": "string"
}
]
}Возвращает возможные причины отмены для заказа.
| order_number | string Номер заказа. |
Array of objects Информация о причинах отмены. | |||||
Array ()
| |||||
{- "order_number": "string"
}{- "reasons": [
- {
- "id": 0,
- "name": "string"
}
]
}Возвращает возможные причины отмены для отправления.
| posting_number | string Номер отправления. |
Array of objects Информация о причинах отмены. | |||||
Array ()
| |||||
{- "posting_number": "string"
}{- "reasons": [
- {
- "id": 0,
- "name": "string"
}
]
}Проверяет доступность доставки Ozon для покупателя. Не учитывает ограничения по сумме покупки, категории товаров и географии.
| client_phone | string 7XXXXXXXXXX Номер телефона покупателя. |
| is_possible | boolean
|
{- "client_phone": "string"
}{- "is_possible": true
}Проверяет доступность доставки товаров на указанный адрес или в точку выдачи и отображает сроки доставки.
Проверяйте наличие товаров и маршруты во время оформления заказа, чтобы точно рассчитать сроки доставки.
| buyer_phone | string Номер телефона покупателя. |
| delivery_schema | string Default: "MIX" Enum: "MIX" "FBO" "FBS" Схема доставки:
|
object Способ доставки. | |
Array of objects <= 1000 items Информация о товарах. |
Array of objects Результат запроса. | |||||||||||
Array ()
| |||||||||||
{- "buyer_phone": "string",
- "delivery_schema": "MIX",
- "delivery_type": {
- "courier": {
- "coordinates": {
- "latitude": 0,
- "longitude": 0
}
}, - "pick_up": {
- "map_point_id": 0
}
}, - "items": [
- {
- "quantity": 0,
- "sku": 0
}
]
}{- "splits": [
- {
- "delivery_method": {
- "delivery_time_zone_offset": 0,
- "delivery_type": "UNSPECIFIED",
- "id": 0,
- "name": "string",
- "timeslots": [
- {
- "client_date_range": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}, - "logistic_date_range": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}, - "timeslot_id": 0
}
], - "unavailable_reason": "UNSPECIFIED",
- "warehouse_time_zone_offset": 0
}, - "delivery_schema": "UNSPECIFIED",
- "items": [
- {
- "quantity": 0,
- "sku": 0
}
], - "unavailable_reason": "UNSPECIFIED",
- "warehouse_id": 0
}
]
}Возвращает объединённые кластеры точек самовывоза на области из параметра viewport.
Используйте значения из параметра clusters.viewport, чтобы получить список точек или мелких кластеров внутри большого кластера.
Используйте метод /v1/delivery/point/info, чтобы получить информацию о конкретной точке самовывоза.
object Область карты для получения кластеров и точек самовывоза. | |
| zoom | integer <int32> [ 0 .. 19 ] Масштаб карты. |
Array of objects Кластеры. | |||||||||||
Array ()
| |||||||||||
{- "viewport": {
- "left_bottom": {
- "lat": 0,
- "long": 0
}, - "right_top": {
- "lat": 0,
- "long": 0
}
}, - "zoom": 0
}{- "clusters": [
- {
- "coordinate": {
- "lat": 0,
- "long": 0
}, - "is_same_building": true,
- "map_point_ids": [
- "string"
], - "points_count": 0,
- "viewport": {
- "left_bottom": {
- "lat": 0,
- "long": 0
}, - "right_top": {
- "lat": 0,
- "long": 0
}
}
}
]
}Возвращает подробную информацию о точке самовывоза для пользователя.
| map_point_ids | Array of strings <int64> <= 100 items Идентификаторы точек на карте. |
Array of objects Информация о пунктах самовывоза. | |||||
Array ()
| |||||
{- "map_point_ids": [
- "string"
]
}{- "points": [
- {
- "delivery_method": {
- "address": "string",
- "address_details": {
- "city": "string",
- "house": "string",
- "region": "string",
- "street": "string"
}, - "coordinates": {
- "lat": 0,
- "long": 0
}, - "delivery_type": {
- "id": 0,
- "name": "string"
}, - "description": "string",
- "fitting_rooms_count": 0,
- "holidays": [
- {
- "begin": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z"
}
], - "holidays_filled": true,
- "images": [
- "string"
], - "location_id": "string",
- "map_point_id": 0,
- "name": "string",
- "properties": [
- {
- "enabled": true,
- "name": "string"
}
], - "pvz_rating": 0,
- "storage_period": 0,
- "working_hours": [
- {
- "date": "2019-08-24T14:15:22Z",
- "periods": [
- {
- "max": {
- "hours": 0,
- "minutes": 0
}, - "min": {
- "hours": 0,
- "minutes": 0
}
}
]
}
]
}, - "enabled": true
}
]
}Возвращает координаты всех точек самовывоза без объединения в кластеры.
Array of objects Точки самовывоза. | |||||
Array ()
| |||||
{ }{- "points": [
- {
- "coordinate": {
- "lat": 0,
- "long": 0
}, - "map_point_id": 0
}
]
}Отменяет заказ со всеми отправлениями. Используйте идентификатор причины отмены reasons.id из метода /v1/cancel-reason/list-by-order.
| order_number required | string Номер заказа. |
| reason_id required | integer <int32> Идентификатор причины отмены заказа. |
| reason_message | string Причина отмены заказа. |
| message | string Статус обработки отмены. |
{- "order_number": "string",
- "reason_id": 0,
- "reason_message": "string"
}{- "message": "string"
}Возвращает возможность отмены заказа для покупателя.
| order_number required | string Номер заказа. |
| cancellable | boolean
|
| order_number | string Номер заказа. |
Array of objects Группы отправлений. | |
Array of objects Информация о возможности отмены отправлений. |
{- "order_number": "string"
}{- "cancellable": true,
- "order_number": "string",
- "posting_groups": [
- {
- "posting_numbers": [
- "string"
]
}
], - "postings": [
- {
- "cancellable": true,
- "posting_number": "string",
- "why_not_cancellable": "string"
}
]
}| order_number required | string Номер заказа. |
| order_number | string Номер заказа. |
| posting_number | Array of strings Список отправлений в заказе. |
| state | string Статус отмены заказа. |
{- "order_number": "string"
}{- "order_number": "string",
- "posting_number": [
- "string"
], - "state": "string"
}Создаёт заказ для покупателя и получателя в системе Ozon. Передайте вариант доставки из ответа метода /v2/delivery/checkout.
В ответе могут быть не все отправления. Получите список всех отправлений по номеру заказа order_number методом:
required | object Информация о покупателе. |
required | courier (object) or pick_up (object) Информация о доставке. |
| delivery_schema | string Default: "MIX" Enum: "MIX" "FBO" "FBS" Схема доставки:
|
required | object Информация о получателе. |
required | Array of objects Информация об отправлениях в заказе. |
| order_number | string Номер заказа. |
| postings | Array of strings Отправления. |
{- "buyer": {
- "first_name": "string",
- "last_name": "string",
- "middle_name": "string",
- "phone": "string"
}, - "delivery": { },
- "delivery_schema": "MIX",
- "recipient": {
- "recipient_first_name": "string",
- "recipient_last_name": "string",
- "recipient_middle_name": "string",
- "recipient_phone": "string"
}, - "splits": [
- {
- "delivery_method": {
- "delivery_method_id": 0,
- "delivery_type": "COURIER",
- "logistic_date_range": {
- "from": "2019-08-24T14:15:22Z",
- "to": "2019-08-24T14:15:22Z"
}, - "price": {
- "currency_code": "string",
- "nanos": 0,
- "units": 0
}, - "timeslot_id": 0
}, - "items": [
- {
- "price": {
- "currency_code": "string",
- "nanos": 0,
- "units": 0
}, - "quantity": 0,
- "sku": 0
}
], - "warehouse_id": 0
}
]
}{- "order_number": "string",
- "postings": [
- "string"
]
}Отменяет отправление из заказа. Используйте идентификатор причины отмены reasons.id из метода /v1/cancel-reason/list-by-posting.
| posting_number required | string Номер отправления. |
| reason_id required | integer <int32> Идентификатор причины отмены. |
| reason_message | string Дополнительная информация по отмене. |
| message | string Текст сообщения. |
{- "posting_number": "string",
- "reason_id": 0,
- "reason_message": "string"
}{- "message": "string"
}| posting_number | string Идентификатор отправления. |
| order_number | string Номер заказа. |
| posting_number | Array of strings Идентификатор отправления. |
| state | string Статус отмены отправления. |
{- "posting_number": "string"
}{- "order_number": "string",
- "posting_number": [
- "string"
], - "state": "string"
}Возвращает статусы выдачи экземпляров и коды маркировки «Честный ЗНАК» для каждого отправления.
Укажите в чеке и выведите из оборота маркировки экземпляров из параметра issued_exemplars в ответе.
| posting_numbers | Array of strings Идентификаторы отправлений. |
| invalid_postings | Array of strings Список неверных идентификаторов отправлений. |
Array of objects Список выданных покупателям экземпляров товаров. | |
Array of objects Список не выданных покупателям экземпляров товаров. |
{- "posting_numbers": [
- "string"
]
}{- "invalid_postings": [
- "string"
], - "issued_exemplars": [
- {
- "exemplar_id": 0,
- "mandatory_marks": [
- "string"
], - "posting_number": "string",
- "sku": 0
}
], - "non_issued_exemplars": [
- {
- "exemplar_id": 0,
- "posting_number": "string",
- "sku": 0
}
]
}| Ошибка | Описание |
|---|---|
Circle is open |
Если выполняется большое количество запросов, система блокирует работу метода. В течение нескольких минут метод начнет работать как обычно. |
Internal error |
Сервер не успел обработать запрос. |
Invalid Api-Key, please check the key and try again |
Неверный Api-Key: проверьте ключ и повторите попытку. |
Api-key is deactivated, use another one or generate a new one |
Api-Key деактивирован: используйте другой ключ или сгенерируйте новый. |
Api-Key is missing a required role for a method |
У Api-Key нет нужной роли для работы метода. |
Api-Key is restricted to specific IP addresses |
Доступ к Api-Key разрешён только с определённых IP-адресов. |
You have reached request rate limit per second |
Вы превысили лимит запросов: максимум 50 запросов в секунду с одного Client ID. Также учитываются ограничения конкретных методов. |
| Ошибка | Описание |
|---|---|
GTD_MUST_BE_SPECIFIED_FOR_PRODUCT_COUNTRY |
Не указан номер ГТД. Если ГТД нет, передайте is_gtd_absent: true. |
| Ошибка | Описание |
|---|---|
product_is_not_created |
Товар не прошёл модерацию, поэтому обновить остатки пока нельзя. Дождитесь статуса price_sent и попробуйте ещё раз. |
offer_id_not_found |
Товара с таким артикулом нет в личном кабинете. |
FLAMMABLE_ONLY_ON_SELF_OR_PROVIDER_DELIVERY |
Легковоспламеняющиеся товары можно продавать только со своего склада с доставкой самостоятельно или сторонней службой. Выберите другой склад или создайте новый и попробуйте ещё раз. |
WAREHOUSE_NOT_FOUND |
Склад warehouse_id не найден. Проверьте наличие ошибок в ID склада и его статус — он должен быть активный. |
PRODUCT_HAS_NOT_BEEN_TAGGED_YET |
Товар ещё не пометили тегами «КГТ» или «неКГТ», так как не указаны габариты товара или система для расстановки тегов ещё не обработала его. |
NON_KGT_ON_KGT_WAREHOUSE |
Попытка установить или обновить остаток некрупногабаритного товара на КГТ складе. |
PRICE_IS_NOT_SENT |
Товар ещё не создан или находится на стадии обновления. |
MP_DELIVERY_ONLY_3PL_ERROR |
Товар нельзя размещать на складе с методом доставки «Ozon логистика». |
TOO_MANY_REQUESTS |
Вы слишком часто обновляли остатки для одного артикула. Остатки для одного артикула можно обновлять не чаще одного раза в 30 секунд. |
Stock is updated too frequently |
Вы пытаетесь обновить остаток одного и того же товара слишком часто. Обновлять остатки товара на одном складе можно только 1 раз в 30 секунд. Убедитесь, что ваша интеграция не обновляет остатки в фоновом режиме. |
MULTIBOX_NOT_ALLOWED_FOR_FBS |
При работе по схеме FBS нельзя объединить товары из нескольких коробок в один товар. Удалите значение из поля stock и повторите попытку. |
OVER_MAX_OVH_NON_KGT |
Через выбранный склад нельзя продавать крупногабаритные товары. Выберите другой склад или создайте новый и повторите попытку. |
OVER_MAX_OVH_KGT |
Вес или габариты товара превышают максимальные значения для выбранного склада. Измените характеристики товара или выберите другой склад. |
SOURCE_TYPE_NOT_FOUND |
У товара нет SKU. Проверьте, что товар создан и правильно настроен. |
Request validation error: invalid ProductsStocksRequest.Stocks[0]: embedded message failed validation |
В запросе не указан идентификатор склада. Его можно узнать с помощью метода /v1/warehouse/list. |
STOCK_TOO_BIG |
Вы указали слишком большое значение для остатка товара. Укажите количество меньше миллиона и повторите запрос. |
FLAMMABLE_ON_NON_KGT_WAREHOUSE |
Легковоспламеняемые товары можно продавать только со склада для крупногабаритных товаров. Выберите другой склад или создайте новый. |
NOT_FOUND_ERROR |
Товар не найден в личном кабинете. |
SIZE_REQUIRED_FOR_NOT_UNIQUE_OFFER_ID |
Артикул совпадает с артикулом другого товара. Для обычного товара укажите параметр quant_size = 1, а для кванта — quant_size = 2 и больше. |
CB_DELIVERY_ONLY_FBP |
Этот товар доступен к продаже только с FBP склада. |
| Ошибка | Описание |
|---|---|
MAX_OFFSET_EXCEEDED |
Вы превысили лимит количества элементов в запросе. Убедитесь, что значение в поле offset не больше 20000. |
| Ошибка | Описание |
|---|---|
TRANSITION_IS_NOT_POSSIBLE |
Вы передали некорректный порядок статусов заказов rFBS. Получите текущий статус отправления методом /v3/posting/fbs/get. Изменение статуса происходит асинхронно. |
HAS_INCORRECT_TPL_INTEGRATION_TYPE |
Попытка передать статус на заказ rFBS при доставке интегрированной службой доставки. |
POSTING_NOT_FOUND |
Заказа нет в личном кабинете партнёра. |
POSTING_ALREADY_CANCELLED |
Заказ уже отменён. |
POSTING_ALREADY_SHIPPED |
Заказ уже собран. |
HAS_INCORRECT_STATUS |
У заказа некорректный статус. |
HAS_INCORRECT_PRODUCT_QUANTITY |
Неправильное количество продуктов или неправильный SKU в запросе. |
UNKNOW_PRODUCT/UNKNOWN_PRODUCT_DEFINED |
Указан неверный идентификатор товара в системе продавца — product_id. Проверьте, что в поле product_id вы указали идентификатор товара в системе Ozon — SKU. |
EXEMPLAR_INFO_ALREADY_DEFINED |
Информация об экземплярах товара уже обновлена. Передавать данные повторно не нужно. |
MANDATORY_MARK_REDUNDANT |
Для товара не нужно передавать код маркировки. |
EXEMPLAR_INFO_NOT_FILLED_COMPLETELY |
Убедитесь, что вы передали всю информацию по экземплярам товаров в заказе. |
SHIP_FBP_POSTINGS_IS_FORBIDDEN |
FBP постинг не требует сборки. |
| Ошибка | Описание |
|---|---|
The next postings aren't ready |
Товар ещё не готов к печати маркировки. |
INVALID_ARGUMENT |
Переданы неверные значения в теле запроса. Печать этикетки возможна только для заказов со статусом «Ожидает отгрузки» — awaiting_deliver. Проверьте, что у отправления верный статус и что переданы корректные данные. |
NO_POSTINGS_FOR_BATCH_DOWNLOAD |
В запросе нет заказов со статусом «Ожидает отгрузки». |
| Ошибка | Описание |
|---|---|
POSTING_NUMBERS_IS_INCORRECT_FOR_COMPANY |
Проверьте, что отправление относится к Client ID, с которого поступает запрос. |
| Ошибка | Описание |
|---|---|
can't create carriage |
Перевозка ещё не готова к созданию. Добавьте акты на отгрузку. |
Company has no FBS-warehouses |
У вас нет созданного склада FBS. |
DELIVERY_METHOD_NOT_FOUND |
Вы передали некорректный идентификатор метода доставки — delivery_method_id. |
first_mile_absent |
Для метода доставки не указан способ отгрузки. Подробнее о настройке склада |
first_mile_is_changing |
Обновляются настройки склада. Отгрузка станет доступна после обновления. |
has_overflow |
Пункт перегружен. Выберите другой, чтобы сроки доставки не увеличивались. |
has_postings_with_registration_error |
Часть отправлений не может попасть в акт из-за ошибки регистрации в сервисе доставки. |
has_seller_returns_in_stock |
Заберите возвраты. |
has_surge |
Пункт приёма переполнен и стоимость отгрузки временно увеличена. Для экономии выберите менее загруженный пункт. |
new_postings_are_possible |
В отгрузку ещё могут попасть новые отправления. Используйте метод, когда закончится сегодняшнее время на сборку заказов. |
no_postings |
Для выбранного метода нет доступных отправлений. |
non_carriageable |
Отгрузка не требуется. |
not_accepted_on_sc |
Обработайте отправления на вкладке Спорные в личном кабинете. Чтобы добавить оправление в уже созданную отгрузку, отмените предыдущую и создайте новую. |
not_packaged |
У вас есть отправления, которые нужно передать в доставку сегодня — добавьте их в отгрузку. |
not_registered |
Регистрируем отправления в сервисе доставки. Сформируйте акт, когда все отправления получат статус awaiting_deliver — готов к отгрузке. |
other |
Возникла ошибка. Обратитесь за помощью в поддержку. |
outdated |
Указана прошедшая дата. |
package_time_not_passed |
Время для формирования отгрузки ещё не наступило. |
partial_carriage_formed |
Все частичные перевозки созданы. |
partial_carriage_in_proccess |
Создайте ещё несколько частичных перевозок. |
posting_statuses_not_ready |
Формируем отгрузку. Повторите запрос через несколько минут. |
there_are_incomplete_carriages |
Есть незавершённые перевозки. |
Trying set ContainersCount to not HasEntrustedAcceptance company |
Чтобы передать количество грузовых мест, подключитесь к доверительной приёмке. Подробнее о доверительной приёмке |
will_be_partial_carriage |
Создайте несколько частичных перевозок. |
Incorrect_carriage_status |
Перевозка ещё не сформировалась. Акт должен быть в статусе sended или formed. Чтобы получить статус, используйте метод /v2/posting/fbs/act/list. |
| Ошибка | Описание |
|---|---|
invalid_cat egory_price |
Попытка установить слишком высокую или слишком низкую цену на товар. |
discount_for_average_price_is_too_small |
Слишком маленькая скидка. Если цена после скидки от 400 до 10 000 рублей включительно, разница между ценами до и после скидки должна быть больше 5%. |
discount_for_low_price_is_too_small |
Слишком маленькая скидка. Если цена после скидки 400 рублей или ниже, разница между ценами до и после скидки должна быть больше 20 рублей. |
discount_too_big |
Слишком большая скидка. Разница между ценами до и после скидки должна быть меньше 90%. |
discount_for_top_price_is_too_small |
Слишком маленькая скидка. Если цена после скидки выше 10 000 рублей, разница между ценами до и после скидки должна быть больше 500 рублей. |
price_negative |
Попытка установить отрицательную цену. |
NOT_FOUND_ERROR |
Товара с таким идентификатором нет в личном кабинете. |
error limiting: acquire limit per item: items limit: limit exceeded |
Вы слишком часто обновляли цены для товара. Обновлять цену товара можно только 10 раз в 1 час. |
| Ошибка | Описание |
|---|---|
SPU_already_exists |
Товар с такими характеристиками уже существует. |
"Invalid_state" - Product is not ready to supply |
Товар не готов к обновлению остатков. Возможно, товар не создан или аккаунт не активирован. |
Incorrect_density |
Товар не прошёл проверку на плотность. Указанная вами плотность находится вне допустимого диапазона. Минимальное значение плотности — 0,001, максимальное — 13,55. Плотность рассчитывается по формуле: вес × 1000 ÷ (высота × ширина × глубина). Также проверьте, что вы используете корректные значения массы и объёма для вашего товара. |
price_is_negative |
Не указана цена — price. |
| Ошибка | Описание |
|---|---|
CREATE_ORDER_ERROR_REASON_INVALID_STORAGE_WAREHOUSE |
Конечный склад размещения указан неверно. Получите доступные склады методом /v1/draft/create/info. |
| Ошибка | Описание |
|---|---|
WAREHOUSE_SCORING_INVALID_REASON_NOT_AVAILABLE_MATRIX |
Склад не может принять все товары из состава черновика is_available = false. Выберите другой склад размещения. |
ITEM_REJECTION_REASON_OUT_OF_ASSORTMENT |
Товарный состав не найден. Проверьте, что SKU существуют у продавца и вы передали их корректно. |
| Ошибка | Описание |
|---|---|
result: items: 0 |
Убедитесь, что указана корректная категория товара и проставлен НДС . |
| Ошибка | Описание |
|---|---|
HAS_INCORRECT_CANCEL_REASON |
Указан неправильный идентификатор отмены заказа. |
| Ошибка | Описание |
|---|---|
GTD_IS_REQUIRED_ONLY_FOR_LEGAL_CUSTOMER |
Грузовую таможенную декларацию должны передавать только юридическим лицам. |
EXEMPLAR_ID does not belong to product PRODUCT_ID |
Идентификатор экземпляра exemplar_id не соответствует идентификатору товара product_id. Получите корректный exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get. |
Posting must have 'awaiting_packaging' status |
У заказа некорректный статус. Для передачи данных или проверки статуса отправление должно быть в статусе «Ожидает сборки» — awaiting_packaging. |
| Ошибка | Описание |
|---|---|
restore limit exceeded |
Вы превысили лимит на восстановление карточек товаров, которые были архивированы автоматически. В сутки можно восстановить не больше 10 карточек. Лимит обновляется в 03:00 по московскому времени. |
total limit exceeded |
Вы превысили лимит на ассортимент в личном кабинете. Отредактируйте активные карточки или перенесите часть из них в архив. Лимит на ассортимент можно узнать через метод /v4/product/info/limit. |
| Ошибка | Описание |
|---|---|
POSTING_NOT_FOUND |
Нет новых отправлений для добавления в отгрузку. Подтвердите предыдущую отгрузку методом v1/carriage/approve или добавьте новые отправления в существующую отгрузку методом /v1/carriage/set-postings. |
В разделе описано, как подключить пуш-уведомления, чтобы получать от Ozon на свой сервис информацию о событиях:
Также можно получать информацию о сообщениях и уведомлениях, которые не были доставлены из-за недоступности вашего сервиса.
Отключить уведомления можно в разделе Настройки → Уведомления на вкладке Push уведомления.
| Ошибка | Описание | Решение |
|---|---|---|
| REQUEST_ERROR | Запрос не отправлен, нет подключения по указанному адресу. | Проверьте, что ваш сервис работает. |
| REQUEST_TIMEOUT | Превышено время ожидания запроса. | Увеличьте время ожидания запроса. |
| SERVER_FAULT | Ваш сервис вернул внутреннюю ошибку сервера. | Изучите логи сервера, обновите серверное ПО, увеличьте выделенные ресурсы или обратитесь к администратору сервера. |
| STATUS_CODE_NOT_OK | HTTP-статус ответа сервиса не равен 200. | Проверьте передаваемый код статуса. |
| EMPTY_BODY | Тело ответа пустое или отсутствует. | Проверьте, что ответ на сервере сформирован правильно, и, что данные корректно передаются. |
| INVALID_BODY | Некорректный формат тела ответа. | Проверьте формат ответа и убедитесь, что заголовок Content-Type равен application/json. |
| INVALID_JSON | Ошибка при разборе или валидации JSON-данных. | Проверьте правильность JSON-данных и исправьте ошибки в синтаксисе. |
| WRONG_RESULT_FIELD | Ваш сервис вернул тело ответа не по шаблону. | Проверьте, что формат ответа соответствует шаблону. Подробнее о шаблоне |
| WRONG_RESULT_TIME_FIELD | Некорректное поле time в теле ответа. |
Проверьте формат времени в ответе. |
{
"message_type": "string",
"time": "2019-08-24T14:15:22Z"
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_PING. |
time |
string | date-time | Дата и время отправки уведомления в формате UTC. |
При успешной обработке уведомления сервис должен вернуть ответ с кодом HTTP 200:
{
"version": "string",
"name": "string",
"time": "2019-08-24T14:15:22Z"
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
version |
string | — | Версия приложения. |
name |
string | — | Название приложения. |
time |
string | date-time | Дата и время начала обработки уведомления в формате UTC. |
При ошибке во время обработки уведомления сервис должен вернуть ответ с кодом HTTP из групп 4xx или 5xx:
{
"error": {
"code": "ERROR_UNKNOWN",
"message": "ошибка",
"details": null
}
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
error |
object | — | Информация об ошибке. |
code |
string | — | Код ошибки: • ERROR_UNKNOWN — неизвестная ошибка.• ERROR_PARAMETER_VALUE_MISSED — не указано значение одного или нескольких параметров.• ERROR_REQUEST_DUPLICATED — дублирующийся запрос. |
message |
string | — | Детальное описание ошибки. |
details |
string | — | Дополнительная информация. |
Если уведомление не доставлено, через несколько секунд система попытается отправить запрос ещё несколько раз. Интервал между попытками будет постепенно увеличиваться. Когда он достигнет максимального значения в 10 минут, будет ещё 5 попыток каждые 10 минут.
Если сообщение по-прежнему не получится доставить, попытки отправки запроса прекратятся.
Отправка всех уведомлений будет приостановлена, если соблюдено хотя бы одно из условий:
200 меньше половины от всех уведомлений;Чтобы снова получать уведомления, в личном кабинете продавца повторно подтвердите URL-адрес сервиса.
Для каждого из типов уведомлений Ozon отправляет REST-запросы на адрес вашего сервиса. Ваш сервис должен отвечать по стандартам REST API.
| Тип | Назначение |
|---|---|
| TYPE_PING | Проверка статуса готовности сервиса при первичном подключении и периодически после подключения |
| TYPE_NEW_POSTING | Новое отправление |
| TYPE_POSTING_CANCELLED | Отмена отправления |
| TYPE_STATE_CHANGED | Изменение статуса отправления |
| TYPE_CUTOFF_DATE_CHANGED | Изменение даты отгрузки отправления |
| TYPE_DELIVERY_DATE_CHANGED | Изменение даты доставки отправления |
| TYPE_CREATE_OR_UPDATE_ITEM | Создание и обновление товара или ошибка в процессе |
| TYPE_CREATE_ITEM | Создание товара или ошибка при его создании |
| TYPE_UPDATE_ITEM | Обновление товара или ошибка при обновлении |
| TYPE_STOCKS_CHANGED | Изменение остатков на складах продавца |
| TYPE_NEW_MESSAGE | Новое сообщение в чате |
| TYPE_UPDATE_MESSAGE | Изменение сообщения в чате |
| TYPE_MESSAGE_READ | Ваше сообщение прочитано покупателем или поддержкой |
| TYPE_CHAT_CLOSED | Чат закрыт |
Уведомления приходят только для FBS и rFBS отправлений:
{
"message_type": "TYPE_NEW_POSTING",
"posting_number": "24319409-0021-1",
"products": [
{
"sku": 147451939,
"offer_id": "Товар2",
"quantity": 1
}
],
"in_process_at": "2021-01-26T06:56:36.294Z",
"warehouse_id": 12850503335000,
"shipment_date": "2021-01-26T06:56:36.294Z",
"tpl_integration_type": "3pl_tracking",
"is_express": false,
"tracking_number": "ZZV-23",
"delivery_date_begin": "2025-01-26T06:56:36.294Z",
"delivery_date_end": "2025-01-26T06:56:36.294Z",
"seller_id": 1
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_NEW_POSTING. |
posting_number |
string | — | Номер отправления. |
products |
array | — | Информация о товарах. |
sku |
integer | int64 | Идентификатор товара в системе Ozon — SKU. |
offer_id |
string | — | Идентификатор товара в системе продавца — артикул. |
quantity |
integer | int64 | Количество товара. |
in_process_at |
string | date-time | Дата и время начала обработки отправления в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада. |
shipment_date |
string | date-time | Дата и время, до которой необходимо собрать отправление. |
tpl_integration_type |
string | — | Тип интеграции со службой доставки:
|
is_express |
boolean | — | Признак доставки express. |
tracking_number |
string | — | Трек-номер отправления. |
delivery_date_begin |
string | date-time | Дата и время начала доставки. |
delivery_date_end |
string | date-time | Дата и время конца доставки. |
seller_id |
integer | int64 | Идентификатор продавца. |
Уведомления приходят только для FBS и rFBS отправлений:
{
"message_type": "TYPE_POSTING_CANCELLED",
"posting_number": "24219509-0020-1",
"products": [
{
"sku": 147451959,
"quantity": 1
}
],
"old_state": "posting_transferred_to_courier_service",
"new_state": "posting_canceled",
"changed_state_date": "2021-01-26T06:56:36.294Z",
"reason": {
"id": 0,
"message": "string"
},
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_POSTING_CANCELLED. |
posting_number |
string | — | Номер отправления. |
products |
array | — | Информация о товарах. |
sku |
integer | int64 | Идентификатор товара в системе Ozon — SKU. |
quantity |
integer | int64 | Количество товара. |
old_state |
string | — | Предыдущий статус отправления. |
new_state |
string | — | Новый статус отправления: posting_canceled — отменено. |
changed_state_date |
string | date-time | Дата и время изменения статуса отправления в формате UTC. |
reason |
object | — | Информация о причине отмены. |
id |
integer | int64 | Идентификатор причины отмены. |
message |
string | — | Причина отмены. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
posting_acceptance_in_progress — идёт приёмка,posting_created — создано,posting_transferring_to_delivery — передаётся в доставку,posting_in_carriage — в перевозке,posting_not_in_carriage — не добавлен в перевозку,posting_in_client_arbitration — клиентский арбитраж доставки,posting_on_way_to_city — на пути в город,posting_transferred_to_courier_service — передаётся курьеру,posting_in_courier_service — курьер в пути,posting_on_way_to_pickup_point — на пути в пункт выдачи,posting_in_pickup_point — в пункте выдачи,posting_conditionally_delivered — условно доставлено,posting_driver_pick_up — у водителя,posting_not_in_sort_center — не принят на сортировочном центре.Соответствие статусных моделей Seller API и статусов пуш-модели.
| Seller API | Push-модель | ||
|---|---|---|---|
| Статус | Описание | Статус | Описание |
acceptance_in_progress |
Идёт приёмка. | posting_acceptance_in_progress |
Идёт приёмка. |
awaiting_approve |
Ожидает подтверждения. | posting_created |
Создана. |
awaiting_packaging |
Ожидает упаковки. | posting_created |
Создана. |
awaiting_registration |
Ожидает регистрации. | posting_awaiting_registration |
Ожидает регистрации. |
awaiting_deliver |
Ожидает отгрузки. | posting_transferring_to_delivery |
Передаётся в доставку. |
posting_in_carriage |
В перевозке. | ||
posting_not_in_carriage |
Не добавлен в перевозку. | ||
arbitration |
Арбитраж. | posting_in_arbitration |
Арбитраж. |
client_arbitration |
Клиентский арбитраж доставки. | posting_in_client_arbitration |
Клиентский арбитраж. |
delivering |
Доставляется. | posting_on_way_to_city |
На пути в ваш город. |
posting_transferred_to_courier_service |
Передаётся курьеру. | ||
posting_in_courier_service |
Курьер в пути. | ||
posting_on_way_to_pickup_point |
На пути в пункт выдачи. | ||
posting_in_pickup_point |
В пункте выдачи. | ||
posting_conditionally_delivered |
Условно доставлено. | ||
driver_pickup |
У водителя. | posting_driver_pick_up |
У водителя. |
delivered |
Доставлено. | posting_delivered |
Доставлено. |
posting_received |
Получено. | ||
cancelled |
Отменено. | posting_canceled |
Отменено. |
not_accepted |
Не принято на сортировочном центре. | posting_not_in_sort_center |
Не принято на сортировочном центре. |
Уведомления приходят только для FBS и rFBS отправлений.
{
"message_type": "TYPE_STATE_CHANGED",
"posting_number": "24219509-0020-2",
"new_state": "posting_delivered",
"changed_state_date": "2021-02-02T15:07:46.765Z",
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_STATE_CHANGED. |
posting_number |
string | — | Номер отправления. |
new_state |
string | — | Новый статус отправления. |
changed_state_date |
string | date-time | Дата и время изменения статуса отправления в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
posting_acceptance_in_progress — идёт приёмка,posting_transferring_to_delivery — передаётся в доставку,posting_in_carriage — в перевозке,posting_not_in_carriage — не добавлен в перевозку,posting_in_arbitration — арбитраж,posting_in_client_arbitration — клиентский арбитраж доставки,posting_on_way_to_city — на пути в город,posting_transferred_to_courier_service — передаётся курьеру,posting_in_courier_service — курьер в пути,posting_on_way_to_pickup_point — на пути в пункт выдачи,posting_in_pickup_point — в пункте выдачи,posting_conditionally_delivered — условно доставлено,posting_driver_pick_up — у водителя,posting_delivered — доставлено,posting_not_in_sort_center — не принят на сортировочном центре.Уведомления приходят только для FBS и rFBS отправлений:
{
"message_type": "TYPE_CUTOFF_DATE_CHANGED",
"posting_number": "24219509-0020-2",
"new_cutoff_date": "2021-11-24T07:00:00Z",
"old_cutoff_date": "2021-11-21T10:00:00Z",
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_CUTOFF_DATE_CHANGED. |
posting_number |
string | — | Номер отправления. |
new_cutoff_date |
string | date-time | Новые дата и время отгрузки в формате UTC. |
old_cutoff_date |
string | date-time | Предыдущие дата и время отгрузки в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_DELIVERY_DATE_CHANGED",
"posting_number": "24219509-0020-2",
"new_delivery_date_begin": "2021-11-24T07:00:00Z",
"new_delivery_date_end": "2021-11-24T16:00:00Z",
"old_delivery_date_begin": "2021-11-21T10:00:00Z",
"old_delivery_date_end": "2021-11-21T19:00:00Z",
"warehouse_id": 0,
"seller_id": 15
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_DELIVERY_DATE_CHANGED. |
posting_number |
string | — | Номер отправления. |
new_delivery_date_begin |
string | date-time | Новые дата и время начала доставки в формате UTC. |
new_delivery_date_end |
string | date-time | Новые дата и время окончания доставки в формате UTC. |
old_delivery_date_begin |
string | date-time | Предыдущие дата и время начала доставки в формате UTC. |
old_delivery_date_end |
string | date-time | Предыдущие дата и время окончания доставки в формате UTC. |
warehouse_id |
integer | int64 | Идентификатор склада, на котором хранятся товары для этого отправления. |
seller_id |
integer | int64 | Идентификатор продавца. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_CREATE_OR_UPDATE_ITEM",
"seller_id": 0,
"offer_id": "string",
"product_id": 0,
"is_error": false,
"changed_at": "2022-09-01T14:15:22Z"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_CREATE_OR_UPDATE_ITEM. |
offer_id |
string | — | Идентификатор товара в системе продавца — артикул. |
product_id |
integer | int64 | Идентификатор товара в системе продавца — product_id. |
is_error |
boolean | — | Признак, что при создании или обновлении товара возникли ошибки: • true — были ошибки, товар не создан или не обновлён;• false — товар создан или обновлён без ошибок. |
changed_at |
string | date-time | Дата и время изменения. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_CREATE_ITEM",
"seller_id": 0,
"offer_id": "string",
"product_id": 0,
"is_error": false,
"changed_at": "2021-09-01T14:15:22Z"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_CREATE_ITEM. |
offer_id |
string | — | Идентификатор товара в системе продавца — артикул. |
product_id |
integer | int64 | Идентификатор товара в системе продавца — product_id. |
is_error |
boolean | — | Признак, что при создании товара возникли ошибки: • true — были ошибки, товар не создан;• false — товар создан без ошибок. |
changed_at |
string | date-time | Дата и время изменения. |
Уведомление, которое отправляет Ozon:
{
"message_type": "TYPE_UPDATE_ITEM",
"seller_id": 0,
"offer_id": "string",
"product_id": 0,
"is_error": false,
"changed_at": "2021-09-01T14:15:22Z"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_UPDATE_ITEM. |
offer_id |
string | — | Идентификатор товара в системе продавца — артикул. |
product_id |
integer | int64 | Идентификатор товара в системе продавца — product_id. |
is_error |
boolean | — | Признак, что при обновлении товара возникли ошибки: • true — были ошибки, товар не создан;• false — товар создан без ошибок. |
changed_at |
string | date-time | Дата и время изменения. |
Уведомление, которое отправляет Ozon:
{
"message_type": "string",
"seller_id": 0,
"items": [
{
"product_id": 0,
"sku": 0,
"updated_at": "2021-09-01T14:15:22Z",
"stocks": [
{
"warehouse_id": 0,
"present": 0,
"reserved": 0
}
]
}
]
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
seller_id |
integer | int64 | Идентификатор продавца. |
message_type |
string | — | Тип уведомления — TYPE_STOCKS_CHANGED. |
items |
array | — | Массив с данными товаров. |
updated_at |
string | date-time | Дата и время изменения. |
sku |
integer | int64 | SKU товара при работе по схемам FBS или rFBS. |
product_id |
integer | int64 | Идентификатор товара в системе продавца — product_id. |
stocks |
array | — | Массив с данными по остаткам товара. |
warehouse_id |
integer | int64 | Идентификатор склада. |
present |
integer | int64 | Общее количество товара на складе. |
reserved |
integer | int64 | Количество зарезервированных товаров на складе. |
{
"message_type": "TYPE_NEW_MESSAGE",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"message_id": "3000000000817031942",
"created_at": "2022-07-18T20:58:04.528Z",
"user": {
"id": "115568",
"type": "Сustomer"
},
"data": [
"Текст сообщения"
],
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_NEW_MESSAGE. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
message_id |
string | — | Идентификатор сообщения. |
created_at |
string | date-time | Дата создания сообщения. |
user |
object | — | Информация об отправителе сообщения. |
id |
string | — | Идентификатор отправителя. |
type |
string | — | Тип отправителя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
data |
array of string | — | Массив с содержимым сообщения в формате Markdown. |
seller_id |
integer | int64 | Идентификатор продавца. |
{
"message_type": "TYPE_UPDATE_MESSAGE",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"message_id": "3000000000817031942",
"created_at": "2022-07-18T20:58:04.528Z",
"updated_at": "2022-07-18T20:59:04.528Z",
"user": {
"id": "115568",
"type": "Сustomer"
},
"data": [
"Текст сообщения"
],
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_UPDATE_MESSAGE. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
message_id |
string | — | Идентификатор сообщения. |
created_at |
string | date-time | Дата создания сообщения. |
updated_at |
string | date-time | Дата изменения сообщения. |
user |
object | — | Информация об отправителе сообщения. |
id |
string | — | Идентификатор отправителя. |
type |
string | — | Тип отправителя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
data |
array of string | — | Массив с содержимым сообщения в формате Markdown. |
seller_id |
integer | int64 | Идентификатор продавца. |
{
"message_type": "TYPE_MESSAGE_READ",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"message_id": "3000000000817031942",
"created_at": "2022-07-18T20:58:04.528Z",
"user": {
"id": "115568",
"type": "Сustomer"
},
"last_read_message_id": "3000000000817031942",
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_MESSAGE_READ. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
message_id |
string | — | Идентификатор сообщения. |
created_at |
string | date-time | Дата создания сообщения. |
user |
object | — | Информация о пользователе, прочитавшем сообщение. |
id |
string | — | Идентификатор пользователя. |
type |
string | — | Тип пользователя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
last_read_message_id |
string | — | Идентификатор последнего прочитанного сообщения. |
seller_id |
integer | int64 | Идентификатор продавца. |
{
"message_type": "TYPE_CHAT_CLOSED",
"chat_id": "b646d975-0c9c-4872-9f41-8b1e57181063",
"chat_type": "Buyer_Seller",
"user": {
"id": "115568",
"type": "Сustomer"
},
"seller_id": "7"
}Параметр |
Тип | Формат | Описание |
|---|---|---|---|
message_type |
string | — | Тип уведомления — TYPE_CHAT_CLOSED. |
chat_id |
string | — | Идентификатор чата. |
chat_type |
string | — | Тип чата: • Seller_Support — чат с поддержкой.• Buyer_Seller — чат с покупателем.• Seller_Notification — уведомления Ozon. |
user |
object | — | Информация о пользователе, закрывшем чат. |
id |
string | — | Идентификатор пользователя. |
type |
string | — | Тип пользователя: • Customer — покупатель.• Support — поддержка.• NotificationUser — Ozon. |
seller_id |
integer | int64 | Идентификатор продавца. |
При успешной обработке уведомления сервис должен вернуть ответ с кодом HTTP 200:
{
"result": true
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
result |
boolean | — | Уведомление получено. |
При ошибке во время обработки уведомления сервис должен вернуть ответ с кодом HTTP из групп 4xx или 5xx:
{
"error": {
"code": "ERROR_UNKNOWN",
"message": "ошибка",
"details": null
}
}
Параметр |
Тип | Формат | Описание |
|---|---|---|---|
error |
object | — | Информация об ошибке. |
code |
string | — | Код ошибки: • ERROR_UNKNOWN — неизвестная ошибка.• ERROR_PARAMETER_VALUE_MISSED — не указано значение одного или нескольких параметров.• ERROR_REQUEST_DUPLICATED — дублирующийся запрос. |
message |
string | — | Детальное описание ошибки. |
details |
string | — | Дополнительная информация. |
| Метод | Что изменилось |
|---|---|
| /v1/warehouse/warehouses-with-invalid-products | Добавили бета-метод для получения списка складов, на которых есть товары с ограничениями по доставке FBS. |
| /v1/warehouse/invalid-products/get | Добавили бета-метод для получения списка товаров с ограничениями по доставке FBS. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/balance | Добавили бета-метод для получения отчёта о балансе. |
| /v1/finance/cash-flow-statement/list | Обновили описание метода. |
| /v1/returns/list | Удалили значение ReturnCompensated параметра filter.visual_status_name в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/digital/codes/upload /v1/posting/digital/list /v1/product/digital/stocks/import |
Перенесли методы из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/rating/history | Обновили описание параметра ratings в запросе метода. |
| — | Добавили описание раздела Управление кодами маркировки и сборкой заказов для FBS/rFBS. |
| Метод | Что изменилось |
|---|---|
| /v1/delivery-method/return/settings/get | Добавили бета-метод для получения информации по возвратным настройкам rFBS и rFBS Express. |
| — | В разделах Работа со складами rFBS Express → Доставка «Партнёры Ozon и Работа со складами rFBS Express → Доставка «Вы или сторонняя служба» обновили порядок работы со складами rFBS Express. |
| Метод | Что изменилось |
|---|---|
| /v1/cluster/list | Добавили параметр clusters.macrolocal_cluster_id в ответ метода. |
| /v1/supply-order/details | Добавили бета-метод для получения подробной информации о заявке на поставку. |
| /v1/warehouse/fbs/create/return-point/list /v1/warehouse/fbs/update/return-point/list /v1/warehouse/fbs/return-mile/info /v1/warehouse/fbs/return-mile/check |
Добавили бета-методы для работы с FBS-складами. |
| /v1/warehouse/fbs/create /v1/warehouse/unarchive /v1/warehouse/archive /v1/warehouse/fbs/first-mile/update |
Добавили параметр return_point_id в запрос метода. |
| /v1/analytics/manage/stocks | Метод устаревает и будет отключён 22 декабря 2025 года. Переключитесь на /v1/analytics/stocks. |
| — | В разделе Порядок работы с методами → Работа с FBS-складами обновили порядок работы с с FBS-складами. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info/stocks-by-warehouse/fbs | Добавили бета-метод для работы с остатками на складах продавца. |
| /v2/delivery-method/list | Добавили бета-метод для получения методов доставки на складе. |
| /v2/carriage/delivery/list | Добавили бета-метод для получения методов доставки и отгрузок. |
| /v1/posting/carriage-available/list /v1/carriage/delivery/list |
Методы устаревают и будут отключены с 2 февраля 2026 года. Переключитесь на /v2/carriage/delivery/list. |
| /v1/product/info/stocks-by-warehouse/fbs | Метод устаревает и будет отключён в будущем. Переключитесь на /v2/product/info/stocks-by-warehouse/fbs. |
| /v1/delivery-method/list | Метод устаревает и будет отключён в будущем. Переключитесь на /v2/delivery-method/list. |
| Метод | Что изменилось |
|---|---|
| /v1/actions/candidates /v1/actions/products |
Добавили параметры result.products.current_boost, result.products.price_min_elastic, result.products.price_max_elastic, result.products.min_boost и result.products.max_boost. |
| /v2/posting/fbo/list /v2/posting/fbo/get |
В ответе методов:
|
| /v3/posting/fbs/get | В ответе метода:
|
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
В ответе методов:
|
| /v2/warehouse/list | Добавили параметры limit и cursor в запрос метода.Добавили параметр cursor в ответ метода. |
| /v1/warehouse/list | Добавили параметры limit и offset в запрос метода. |
| /v4/product/info/stocks | Пометили устаревшим параметр items.stocks.warehouseId в ответе метода. |
| /v1/report/warehouse/stock | Обновили описание параметра warehouseId в запросе метода. |
| /v1/cancel-reason/list /v1/cancel-reason/list-by-order /v1/cancel-reason/list-by-posting |
Добавили описание методов. Обновили описание параметра reasons.id в ответе методов. |
| /v1/delivery/check | Добавили описание метода. Обновили описание параметра client_phone в запросе метода. |
| /v2/delivery/checkout /v1/delivery/map /v1/delivery/point/info /v1/delivery/point/list /v1/order/cancel /v1/order/cancel/check /v2/order/create /v1/posting/cancel /v1/posting/marks |
Добавили описание методов. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Ozon Логистика обновили порядок работы с возвратами. |
| Метод | Что изменилось |
|---|---|
| /v1/product/attributes/update | Обновили описание метода. |
| — | Добавили раздел Порядок работы с методами → Работа со складами rFBS Express. |
| Метод | Что изменилось |
|---|---|
| — | Добавили бета-методы для работы с FBP поставками. |
| /v4/product/info/stocks | Обновили описание параметра items.stocks.type в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/rating/index/fbs/info /v1/rating/index/fbs/posting/list |
Добавили бета-методы для работы с индексом ошибок FBS и rFBS. |
| /v1/returns/list | Добавили параметр filter.compensation_status_id в запрос метода.Добавили параметр returns.compensation_status в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/supply-order/list | Обновили пример запроса. |
| /v1/report/info | Добавили параметр result.expires_at в ответ метода. |
| /v1/report/list | Добавили параметр result.reports.expires_at в ответ метода. |
| /v1/carriage/delivery/list | Обновили описание метода. |
| /v1/supply-order/content/update/validation | Обновили описание параметра editing_errors в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/average-delivery-time /v1/analytics/average-delivery-time/details /v1/analytics/average-delivery-time/summary |
Перенесли методы из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/list | Параметр items.marketing_price в ответе метода устарел, удалили его из документации. |
| /v5/product/info/prices | Параметр price.marketing_price в ответе метода устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| /v1/seller/info | Добавили бета-метод для получения информации о кабинете продавца. |
| /v1/seller/ozon-logistics/info | Добавили бета-метод для получения информации о подключении продавца к Ozon Логистике. |
| Метод | Что изменилось |
|---|---|
| /v1/carriage/ettn/status | Добавили бета-метод для получения статуса проверки электронной ТТН на прослеживаемой перевозке FBS. |
| /v1/posting/fbs/product/traceable/attribute | Добавили бета-метод для получения списка незаполненных атрибутов для прослеживаемых товаров. |
| /v1/posting/fbs/traceable/split | Добавили бета-метод для разделения заказа на прослеживаемые отправления. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.require_blr_traceable_attrs в ответ метода. |
| /v3/posting/fbs/get | Добавили параметр result.require_blr_traceable_attrs в ответ метода. |
| /v3/posting/fbs/list | Добавили параметр filter.is_blr_traceable в запрос метода. |
| /v1/carriage/create | Добавили параметр all_blr_traceable в запрос метода. |
| /v1/carriage/get | Добавили параметр all_blr_traceable в ответ метода. |
| — | Добавили раздел Порядок работы с методами → Схема FBS с электронными ТТН. |
| Метод | Что изменилось |
|---|---|
| /v1/warehouse/erfbs/aggregator/create /v1/warehouse/erfbs/aggregator/delivery-method/update /v1/warehouse/erfbs/non-integrated/create /v1/warehouse/erfbs/non-integrated/delivery-method/update /v1/warehouse/erfbs/update /v2/polygon/bind /v1/polygon/delete /v1/polygon/list /v1/polygon/time/coordinates/update /v1/polygon/time/set |
Добавили бета-методы для работы со складами rFBS Express. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbo/list | Удалили параметр result.financial_data.products.customer_price из ответа метода. |
| — | Добавили раздел с методами Ozon Логистика. |
| Метод | Что изменилось |
|---|---|
| /v1/assembly/carriage/posting/list /v1/assembly/carriage/product/list /v1/assembly/fbs/posting/list /v1/assembly/fbs/product/list |
Добавили бета-методы для работы с листами подбора FBS. |
| /v3/supply-order/list /v3/supply-order/get /v1/supply-order/content/update/validation /v1/product/info/warehouse/stocks |
Перенесли методы из бета-раздела в основной. |
| /v2/supply-order/list /v2/supply-order/get |
Методы устаревают и будут отключены 11 декабря 2025 года. Переключитесь на новые версии — /v3/supply-order/list и /v3/supply-order/get. |
| — | Добавили описание работы с OAuth-токеном. |
| Метод | Что изменилось |
|---|---|
| /v1/report/postings/create | Обновили описание параметра filter.is_express в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/certificate/create | Обновили описание параметра accordance_type_code и добавили возможные значения параметра type_code в запросе метода. |
| /v1/product/certificate/types | Обновили пример ответа метода. |
| /v1/product/info/stocks-by-warehouse/fbs | Добавили параметр offer_id в запрос и параметр results.offer_id в ответ метода. |
| /v1/cargoes/create | Обновили пример метода. |
| /v3/posting/fbs/get | Обновили описание параметра result.substatus в ответе метода. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметра result.postings.substatus в ответе методов. |
| /v4/posting/fbs/ship /v4/posting/fbs/ship/package |
Обновили описание методов. |
| — | В разделе Частые ошибки добавили описания ошибок POSTING_NOT_FOUND для метода /v1/carriage/create и error limiting: acquire limit per item: items limit: limit exceeded для метода /v1/product/import/prices. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.manage_elastic_boosting_through_price в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v1/report/marked-products-sales/create | Добавили бета-метод для получения отчёта по продажам товаров с маркировкой. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.shipment_date_without_delay в ответ методов. |
| /v3/posting/fbs/get | Добавили параметр result.shipment_date_without_delay в ответ метода. |
| — | В разделе Уведомления, которые отправляет Ozon → Новое отправление обновили пример уведомления для нового отправления. |
| Метод | Что изменилось |
|---|---|
| /v1/draft/create /v1/draft/create/info |
Обновили описание методов. |
| /v1/product/stairway-discount/by-quantity/set | Добавили бета-метод для управления скидкой от количества товаров. |
| /v1/product/stairway-discount/by-quantity/get | Добавили бета-метод для получения информации о скидке от количества товаров. |
| /v2/supply-order/list | Обновили описание параметра filter.states в запросе метода. |
| /v2/supply-order/get | Обновили описание параметра order.state в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get /v2/posting/fbo/get /v2/posting/fbo/list /v1/posting/digital/list |
Обновили описание параметра result.financial_data.products.product_id в ответе метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Обновили описание параметра result.postings.financial_data.products.product_id в ответе метода. |
| /v5/fbs/posting/product/exemplar/validate | Обновили описание параметра products.exemplars.marks в ответе метода. |
| /v6/fbs/posting/product/exemplar/set | Обновили описание параметра products.exemplars.marks в запросе метода. |
| /v2/posting/fbs/get-by-barcode | Удалили параметры result.analytics_data и result.financial_data из ответа метода. |
| /v1/warehouse/fbo/list | Обновили описание параметра search в запросе метода. |
| /v3/chat/list | Обновили описание параметра limit в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/finance/realization | Параметры result.header.doc_amount и result.header.vat_amount устаревают, отключим их с 14 декабря 2025 года. |
| /v1/finance/realization/posting | Параметры header.doc_amount и header.vat_amount устаревают, отключим их с 14 декабря 2025 года. |
| Метод | Что изменилось |
|---|---|
| /v1/warehouse/fbs/create/drop-off/timeslot/list /v1/warehouse/fbs/update/drop-off/timeslot/list /v1/warehouse/fbs/create/pick-up/timeslot/list /v1/warehouse/fbs/update/pick-up/timeslot/list |
Добавили бета-методы для работы с таймслотами. |
| /v2/warehouse/list | Добавили параметры warehouses.cut_in_time, warehouses.warehouse_type, warehouses.is_comfort и warehouses.is_express в ответ метода. |
| /v1/warehouse/fbs/create /v1/warehouse/fbs/first-mile/update |
Добавили параметры сut_in_time и timeslot_id в запрос методов. |
| Метод | Что изменилось |
|---|---|
| /v5/product/info/prices | Добавили параметры items.comissions.sales_percent_fbp и items.comissions.sales_percent_rfbs в ответ метода.Добавили возможное значение SUPER параметра items.price_indexes.color_index в ответе метода. |
| /v3/product/info/list | Добавили возможное значение COLOR_INDEX_SUPER параметра items.price_indexes.color_index в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/cargoes/create/info | Добавили новую версию метода для получения информации по установке грузомест. |
| /v1/cargoes/create/info | Метод устаревает и будет отключён в будущем. Переключитесь на новую версию /v2/cargoes/create/info. |
| /v1/cargoes/create | Добавили параметр cargoes.value.items.offer_id в запрос метода. |
| /v3/product/import | Обновили описание параметра items.images в запросе метода.Обновили описание метода. |
| /v1/product/pictures/import | Обновили описание параметра images в запросе метода.Обновили описание метода. |
| Метод | Что изменилось |
|---|---|
| v1/removal/from-stock/list v1/removal/from-supply/list |
Обновили примеры ответов. |
| /v1/question/info | Обновили название метода. Обновили описание и пример ответа метода. |
| /v1/question/top-sku | Обновили описание ответа метода. Обновили описание параметра sku в ответе метода. |
| — | Добавили описания разделов Чаты с покупателями, Аналитические отчёты и Финансовые отчёты. |
| /v1/search-queries/text /v1/search-queries/top |
Добавили методы для работы с поисковыми запросами. |
| /v1/analytics/data /v1/chat/send/message /v1/chat/send/file /v1/chat/start /v3/chat/history /v2/chat/read /v1/finance/realization/by-day /v1/review/comment/create /v1/review/comment/delete /v1/review/comment/list /v1/review/change-status /v1/review/count /v1/review/info /v1/review/list |
Обновили описание методов. |
| Метод | Что изменилось |
|---|---|
| /v5/fbs/posting/product/exemplar/create-or-get /v4/fbs/posting/product/exemplar/set /v5/fbs/posting/product/exemplar/set /v4/fbs/posting/product/exemplar/status /v4/fbs/posting/product/exemplar/validate |
Методы устаревают и будут отключены 3 декабря 2025 года. Переключитесь на новые версии. |
| /v3/product/info/list | Параметр items.marketing_price устаревает, отключим его 12 ноября 2025 года. |
| /v3/product/info/list | Добавили параметр items.availabilities в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/package-label/get | Добавили параметры result.printed_postings_count, result.unprinted_postings.msg, result.unprinted_postings.posting_number и result.unprinted_postings_count в ответ метода. |
| /v3/product/info/list | Параметр items.marketing_price устаревает, отключим его 12 ноября 2025 года. |
| Метод | Что изменилось |
|---|---|
| /v1/product/info/warehouse/stocks | Добавили бета-метод для получения остатков на складе FBS и rFBS. |
| Метод | Что изменилось |
|---|---|
| /v1/report/postings/create | Добавили параметры filter.warehouse_id, filter.delivery_method_id, filter.is_express, with.additional_data, with.analytics_data, with.customer_data и with.jewelry_codes в запрос метода. |
| /v5/product/info/prices | Параметр items.price.marketing_price устаревает, отключим его 12 ноября 2025 года. |
| Метод | Что изменилось |
|---|---|
| /v2/returns/rfbs/list | Обновили описание параметра last_id в запросе метода.Обновили пример ответа. |
| /v2/returns/rfbs/get /v4/product/info/stocks |
Обновили примеры ответов. |
| /v1/cluster/list | Добавили пример запроса. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметров result.postings.status, result.postings.substatus в ответе методов. |
| /v3/posting/fbs/get | В ответе метода: • добавили параметр result.financial_data.products.customer_price; • обновили описание параметров result.requirements.products_requiring_gtd, result.requirements.products_requiring_mandatory_mark, result.requirements.products_requiring_jw_uin, result.requirements.products_requiring_rnpt, result.status, result.substatus и result.previous_substatus, result.financial_data.products.price, result.financial_data.products.old_price, result.customer.phone, result.addressee.phone и result.products.is_marketplace_buyout. |
| /v3/posting/fbs/list | В ответе метода: • добавили параметр result.postings.financial_data.products.customer_price; • обновили описание параметров result.postings.requirements.products_requiring_gtd, result.postings.requirements.products_requiring_mandatory_mark, result.postings.requirements.products_requiring_jw_uin, result.postings.requirements.products_requiring_rnpt, result.postings.financial_data.products.price, result.postings.financial_data.products.old_price, result.postings.customer.phone, result.postings.addressee.phone, result.postings.products.is_marketplace_buyout и result.postings.products.is_marketplace_buyout. |
| /v3/posting/fbs/unfulfilled/list | Обновили описание параметров result.postings.customer.phone, result.postings.addressee.phone, result.postings.products.is_marketplace_buyout и result.products.is_marketplace_buyout в ответе метода. |
| /v2/finance/realization | Обновили описание параметров result.rows.delivery_commission.commission, result.rows.delivery_commission.compensation, result.rows.return_commission.commission и result.rows.return_commission.compensation в ответе метода. |
| /v1/analytics/stocks | Обновили описание параметров items.available_stock_count и items.valid_stock_count в ответе метода. |
| /v4/product/info/limit | Обновили описание параметров total.limit, daily_create.limit и daily_update.limit в ответе метода. |
| /v2/chat/history /v3/chat/history |
Обновили описание параметра from_message_id в запросе методов. |
| /v1/rating/history | Обновили описание параметров ratings = rating_reaction_time и ratings = rating_average_response_time в запросе метода. |
| /v1/analytics/product-queries /v1/analytics/product-queries/details |
Обновили описание параметров page и page_size в запросе методов. Обновили пример запроса. |
| /v1/draft/create | Обновили описание параметра cluster_ids в запросе метода. |
| /v1/draft/create/info | Добавили описание метода. Обновили описание параметров clusters.warehouses и errors.items_validation.reasons в ответе метода. |
| /v1/draft/timeslot/info | Обновили описание метода. Обновили описание параметров draft_id и warehouse_ids в запросе метода. Добавили предупреждение в описание метода. |
| /v1/cargoes/create /v1/cargoes/create/info |
Обновили описание параметра items.value.barcode в запросе методов. |
| /v3/product/import | Пометили параметр items.price как обязательный в запросе метода. Обновили описание параметра result.task_id в ответе метода. Обновили описание параметра items.name в запросе метода. |
| /v2/returns/rfbs/get | Обновили описание параметра return_id в запросе метода. |
| /v2/fbs/posting/delivering /v2/fbs/posting/last-mile /v2/fbs/posting/delivered /v2/posting/fbs/package-label /v2/posting/fbs/package-label/create /v1/posting/digital/codes/upload |
Обновили описание методов. |
| /v4/fbs/posting/product/exemplar/status | Обновили описание параметра status в ответе метода. |
| /v1/actions/products/activate | Добавили лимиты для параметра products в запрос метода. |
| — | В разделе Частые ошибки добавили описания ошибок POSTING_NUMBERS_IS_INCORRECT_FOR_COMPANY для метода /v2/posting/fbs/package-label/create, CREATE_ORDER_ERROR_REASON_INVALID_STORAGE_WAREHOUSE для метода /v1/draft/supply/create, WAREHOUSE_SCORING_INVALID_REASON_NOT_AVAILABLE_MATRIX, ITEM_REJECTION_REASON_OUT_OF_ASSORTMENT для метода /v1/draft/timeslot/info и price_is_negative для метода /v3/product/import. Обновили описание ошибки TRANSITION_IS_NOT_POSSIBLE для метода /v4/posting/fbs/ship. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/content/update/validation | Добавили бета-метод для проверки нового товарного состава. |
| /v1/supply-order/content/update/status | В ответе метода: • добавили параметр new_bundle_id; • обновили описание параметра errors. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/digital/act/get-pdf | Добавили значение waybill для параметра doc_type в запросе метода. |
| /v1/question/list | Обновили описание параметра questions в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/supply-order/list | Добавили бета-метод для получения списка заявок на поставку. |
| /v3/supply-order/get | Добавили бета-метод для получения информации о заявке на поставку. |
| — | Удалили раздел Пуш-уведомления → Уведомления, которые отправляет Ozon → Изменение ценового индекса товара. Удалили уведомление TYPE_PRICE_INDEX_CHANGED из раздела Пуш-уведомления → Уведомления, которые отправляет Ozon. |
| Метод | Что изменилось |
|---|---|
| /v1/question/answer/create | Обновили пример запроса. |
| Метод | Что изменилось |
|---|---|
| — | Добавили раздел Информация по API-ключу. |
| /v1/roles | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| v3/posting/fbs/unfulfilled/list v3/posting/fbs/list |
Добавили параметры result.postings.products.imei и result.postings.requirements.products_requiring_imei в ответ метода. |
| v3/posting/fbs/get | Добавили параметры result.products.has_imei, result.product_exemplars.products.exemplars.imei и result.requirements.products_requiring_imei в ответ метода. |
| v6/fbs/posting/product/exemplar/create-or-get | Обновили описание параметра products.exemplars.marks и добавили параметр products.has_imei в ответ метода. |
| v5/fbs/posting/product/exemplar/validate | Обновили описание параметра products.exemplars.marks в запросе и ответе метода. |
| v6/fbs/posting/product/exemplar/set | Обновили описание параметра products.exemplars.marks в запросе метода. |
| v5/fbs/posting/product/exemplar/status | Обновили описание параметра products.exemplars.marks в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/conditional-cancellation/get /v1/conditional-cancellation/list |
Методы устарели, удалили их из документации. Используйте /v2/conditional-cancellation/list. |
| /v1/conditional-cancellation/approve | Метод устарел, удалили его из документации. Используйте /v2/conditional-cancellation/approve. |
| /v1/conditional-cancellation/reject | Метод устарел, удалили его из документации. Используйте /v2/conditional-cancellation/reject. |
| /v1/supply-order/content/update /v1/supply-order/content/update/status |
Обновили описание параметра errors в ответе методов. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.requirements.products_requiring_weight в ответ методов. |
| /v3/posting/fbs/get | Добавили параметры result.product_exemplars.products.exemplars.weight, result.products.is_weight_needed, result.products.weight_max, result.products.weight_min, result.related_weight_postings и result.requirements.products_requiring_weight в ответ метода. |
| /v5/fbs/posting/product/exemplar/validate | Добавили параметр products.exemplars.weight в запрос и ответ метода. |
| /v5/fbs/posting/product/exemplar/status | Добавили параметры products.exemplars.weight, products.exemplars.weight_check_status и products.exemplars.weight_error_codes в ответ метода. |
| /v6/fbs/posting/product/exemplar/set | Добавили параметр products.exemplars.weight в запрос метода. |
| /v6/fbs/posting/product/exemplar/create-or-get | Добавили параметры products.exemplars.weight, products.is_weight_needed, products.weight_max и products.weight_min в ответ метода. |
| — | В разделах Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема rFBS Стандарт и Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Как работать с заказами с весовыми товарами (rFBS) обновили описание работы с методами. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Порядок работы с методами → Работа с FBS-складами описали порядок работы с FBS-складами. |
| /v1/warehouse/fbs/create/drop-off/list /v1/warehouse/fbs/update/drop-off/list /v1/warehouse/fbs/create /v1/warehouse/fbs/update /v1/warehouse/operation/status /v2/warehouse/list /v1/warehouse/fbs/first-mile/update /v1/warehouse/archive /v1/warehouse/unarchive |
Добавили бета-методы для работы с FBS-складами. |
| /v1/warehouse/list | Обновили описание метода. |
| Метод | Что изменилось |
|---|---|
| — | Добавили раздел Premium-методы и перенесли в него методы, доступные с подпиской Premium. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/list | Добавили параметры items.promotions, items.promotions.is_enabled, items.promotions.type и items.sku в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/products/buyout | Обновили описание метода. |
| Метод | Что изменилось |
|---|---|
| /v1/carriage/set-postings /v1/carriage/cancel /v1/product/action/timer/status /v1/product/action/timer/update |
Перенесли методы из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/chat/send/file /v1/chat/send/message |
Обновили описание методов. |
| /v3/product/info/list | Пометили параметр items.is_prepayment_allowed в ответе метода как устаревший. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/cash-flow-statement/list /v3/finance/transaction/list /v3/finance/transaction/totals |
Обновили описания методов. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/average-delivery-time/summary | Добавили бета-метод для получения общей аналитики по среднему времени доставки. |
| Метод | Что изменилось |
|---|---|
| /v3/chat/list | Добавили новую версию метода для получения информации о чатах по указанным фильтрам. |
| /v2/chat/list | Метод устаревает и будет отключён в будущем. Переключитесь на новую версию /v3/chat/list. |
| /v1/finance/document-b2b-sales/json | Добавили параметр invoices.buyer_info.name в ответ метода. |
| /v2/products/stocks | Обновили описание метода. |
| /v1/posting/digital/list | В ответе метода:
|
| Метод | Что изменилось |
|---|---|
| /v1/removal/from-supply/list | Добавили бета-метод для получения отчёта по вывозу и утилизации с поставки FBO. |
| /v1/removal/from-stock/list | Добавили бета-метод для получения отчёта по вывозу и утилизации со стока FBO. |
| /v1/finance/realization/posting /v2/finance/realization |
Обновили описание методов. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/product-queries /v1/analytics/product-queries/details /v1/finance/compensation /v1/finance/decompensation |
Перенесли методы из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute | Обновили описание параметра result.id в ответе метода. |
| /v3/posting/fbs/get | Обновили описание параметра result.requirements.products_requiring_change_country в ответе метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Обновили описание параметров result.postings.requirements.products_requiring_change_country и result.postings.financial_data.products.actions в ответе методов. |
| /v3/posting/fbs/get /v2/posting/fbo/get /v2/posting/fbo/list |
Обновили описание параметра result.financial_data.products.actions в ответе методов. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/products/buyout /v1/finance/document-b2b-sales/json |
Перенесли методы из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/realization/by-day | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/roles | Добавили бета-метод для получения списка ролей и методов по API-ключу. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get | Добавили параметр result.requirements.products_requiring_change_country в ответ метода. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Добавили параметр result.postings.requirements.products_requiring_change_country в ответ метода. |
| /v1/analytics/data | Обновили описание метода. Обновили описание параметров dimension и metrics в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/products/buyout | Добавили бета-метод для получения отчёта по выкупленным товарам. |
| /v2/posting/fbo/list /v2/posting/fbo/get /v3/posting/fbs/get |
Добавили параметр result.products.is_marketplace_buyout в ответы методов. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.products.is_marketplace_buyout в ответы методов. |
| /v2/chat/history /v3/chat/history /v2/chat/read /v1/chat/start /v1/chat/send/file /v1/chat/send/message |
Обновили описания методов. |
| /v1/posting/digital/codes/upload | Добавили бета-метод для загрузки кодов цифровых товаров. |
| /v1/posting/digital/list | Добавили бета-метод для получения списка отправлений, по которым нужно загрузить коды цифровых товаров. |
| /v1/product/digital/stocks/import | Добавили бета-метод для обновления количества цифровых товаров. |
| /v1/product/upload_digital_codes /v1/product/upload_digital_codes/info |
Методы устарели, удалили их из документации. Используйте методы /v1/posting/digital/list, /v1/posting/digital/codes/upload и /v1/product/digital/stocks/import. |
| — | В разделе Порядок работы с методами → Загрузите и обновите товары обновили описание работы с методами. |
| Метод | Что изменилось |
|---|---|
| /v1/quant/list /v1/quant/get /v1/quant/ship /v1/quant/status |
Методы устарели, удалили их из документации. |
| /v2/products/stocks | Удалили параметры stocks.quant_size из запроса и result.quant_size из ответа метода. |
| — | В разделе Схема FBS Стандарт обновили порядок работы с эконом-товарами. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Частые ошибки добавили описание ошибок restore limit exceeded и total limit exceeded для метода /v1/product/unarchive. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get | Обновили описание параметра result.shipment_date в ответе метода. |
| Частые ошибки | Добавили описание ошибки Stock is updated too frequently и обновили описание ошибки TOO_MANY_REQUESTS для метода /v2/products/stocks. |
| v1/carriage/create | Обновили описание метода. |
| Метод | Что изменилось |
|---|---|
| /v1/pricing-strategy/product/info | Пометили устаревшим параметр result.strategy_competitor_id в ответе метода. |
| /v1/conditional-cancellation/get | Метод устаревает и будет отключён 3 августа 2025 года. Переключитесь на /v2/conditional-cancellation/list. |
| — | В разделе Управляйте заявками на отмену обновили метод для получения заявок на отмену rFBS. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/average-delivery-time | Добавили параметры data.metrics.exact_impact_share и total.exact_impact_share в ответ метода. Пометили устаревшими параметры data.metrics.impact_share и total.impact_share. |
| /v1/analytics/average-delivery-time/details | Добавили параметр data.metrics.exact_impact_share и пометили устаревшим параметр data.metrics.impact_share в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/stocks | Добавили параметры items.ads_cluster, items.days_without_sales_cluster, items.idc_cluster и items.turnover_grade_cluster в ответ метода.Обновили описание параметров items.ads, items.days_without_sales, items.idc и items.turnover_grade в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/quant/list /v1/quant/get /v1/quant/ship /v1/quant/status |
Методы устаревают и будут отключены 26 июня 2025 года. |
| /v2/products/stocks | Пометили устаревшими параметры stocks.quant_size в запросе метода и result.quant_size в ответе метода. 26 июня 2025 они будут отключены. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/stocks | Добавили параметр items.stocks.warehouse_ids в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbo/get /v2/posting/fbo/list |
Добавили параметры with.legal_info в запрос метода и result.legal_info в ответ метода. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Добавили параметры with.legal_info в запрос метода и result.postings.legal_info в ответ метода. |
| /v3/posting/fbs/get | Добавили параметры with.legal_info в запрос метода и result.legal_info в ответ метода. |
| Частые ошибки | Добавили описание ошибки You have reached request rate limit per second для всех методов. |
| /v1/cargoes/create | Обновили описание параметра supply_id в запросе метода. |
| /v2/posting/fbs/act/get-postings | Обновили описание параметра id в запросе метода. |
| /v1/finance/realization/posting | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v2/conditional-cancellation/list /v2/conditional-cancellation/approve /v2/conditional-cancellation/reject |
Перенесли методы из бета-раздела в основной. |
| /v1/conditional-cancellation/list | Метод устаревает и будет отключён 3 августа 2025 года. Переключитесь на новую версию /v2/conditional-cancellation/list. |
| /v1/conditional-cancellation/approve | Метод устаревает и будет отключён 3 августа 2025 года. Переключитесь на новую версию /v2/conditional-cancellation/approve. |
| /v1/conditional-cancellation/reject | Метод устаревает и будет отключён 3 августа 2025 года. Переключитесь на новую версию /v2/conditional-cancellation/reject. |
| Частые ошибки | Обновили описание ошибки INVALID_ARGUMENT для метода /v2/posting/fbs/package-label. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/document-b2b-sales/json | Добавили бета-метод для получения отчёта по продажам юридическим лицам в JSON-формате. |
| /v4/product/info/attributes | Добавили параметр result.attributes_with_defaults в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/stocks | Метод устарел, удалили его из документации. Используйте /v2/products/stock. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/stocks | Обновили описание параметра turnover_grades в запросе метода. Обновили описание параметров items.turnover_grades и items.valid_stock_count в ответе метода. |
| /v3/product/import | Пометили обязательным параметр items.type_id в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v5/product/info/prices | Добавили параметр items.price.net_price в ответ метода. |
| /v2/product/pictures/info | Добавили параметр items.errors в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/average-delivery-time | Добавили бета-метод для получения аналитики по среднему времени доставки. |
| /v1/analytics/average-delivery-time/details | Добавили бета-метод для получения детальной аналитики по среднему времени доставки по кластеру. |
| — | В разделе Порядок работы с методами увеличили лимит запросов — теперь вы можете отправить не больше 50 запросов в секунду на все методы с одного Client ID. Раньше — не больше 10. |
| /v3/product/import | Добавили параметр items.promotions в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/bundle | Добавили параметр items.placement_zone в ответ метода. |
| /v1/cargoes/rules/get | Добавили бета-метод для получения чек-листа с правилами по установке грузомест. |
| /v1/cargoes/delete /v1/cargoes/delete/status |
Добавили бета-методы для удаления грузомест в заявке на поставку. |
| /v1/supply-order/content/update /v1/supply-order/content/update/status |
Добавили бета-методы для редактирования товарного состава в заявке на поставку. |
| Метод | Что изменилось |
|---|---|
| /v1/actions/candidates /v1/actions/products |
Добавили параметры result.products.alert_max_action_price_failed и result.products.alert_max_action_price в ответ методов. |
| Метод | Что изменилось |
|---|---|
| /v3/chat/history | Перенесли метод из бета-раздела в основной. |
| /v2/chat/history | Метод устаревает и будет отключён 13 июля 2025 года. Переключитесь на новую версию /v3/chat/history. |
| — | В разделе Порядок работы с методами → Управляйте чатами указали новый метод для получения истории чата. |
| /v1/returns/rfbs/action/set | Добавили бета-метод для передачи действий для возврата rFBS. |
| /v2/returns/rfbs/reject /v2/returns/rfbs/compensate /v2/returns/rfbs/verify /v2/returns/rfbs/receive-return /v2/returns/rfbs/return-money |
Методы будут отключены в будущем. Переключитесь на метод /v1/returns/rfbs/action/set. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/stocks | Метод будет отключён 27 мая 2025 года. Переключитесь на /v2/products/stocks. |
| Метод | Что изменилось |
|---|---|
| /v2/conditional-cancellation/approve | Добавили бета-метод для подтверждения заявки на отмену rFBS-заказов. |
| /v2/conditional-cancellation/list | Добавили бета-метод для получения списка заявок на отмену rFBS-заказов. |
| /v2/conditional-cancellation/reject | Добавили бета-метод для отклонения заявки на отмену rFBS-заказов. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import | Удалили параметры items.image_group_id и items.premium_price из запроса метода. |
| /v1/product/import/info | Удалили параметр result.items.errors.optional_description_elements из ответа метода. |
| /v1/product/import-by-sku | Удалили параметр items.premium_price из запроса метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Удалили параметры result.postings.financial_data.products.client_price, result.postings.financial_data.products.picking и result.postings.products.mandatory_mark из ответа методов. |
| /v3/posting/fbs/get /v2/posting/fbs/get-by-barcode |
Удалили параметры result.financial_data.products.client_price, result.financial_data.products.picking и result.products.mandatory_mark из ответа методов. |
| /v2/posting/fbo/get /v2/posting/fbo/list |
Удалили параметры result.analytics_data.region, result.financial_data.products.client_price и result.financial_data.products.picking из ответа методов. |
| /v2/supply-order/get | Удалили параметр orders.creation_flow из ответа метода. |
| /v2/analytics/stock_on_warehouses | Удалили параметр result.rows.idc из ответа метода. |
| /v1/finance/realization | Метод устарел, удалили его из документации. Используйте /v2/finance/realization. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/compensation | Добавили бета-метод для получения отчёта о компенсациях. |
| /v1/finance/decompensation | Добавили бета-метод для получения отчёта о декомпенсациях. |
| /v1/report/info | Обновили описание параметра report_type в ответе метода. |
| /v1/report/list | Обновили описание параметра report_type в ответе и запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/realization/posting | Добавили бета-метод для получения позаказного отчёта о реализации товаров. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/manage/stocks | Обновили описание параметра filter.stock_types в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbo/get /v2/posting/fbo/list /v3/posting/fbs/get /v2/posting/fbs/get-by-barcode |
Удалили устаревшие параметры result.financial_data.posting_services и result.financial_data.products.item_services из ответа методов. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Удалили устаревшие параметры result.postings.financial_data.posting_services и result.postings.financial_data.products.item_services из ответа методов. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/realization/by-day | Добавили бета-метод для получения отчёта о реализации товаров за день. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/stocks | Добавили метод для получения аналитики по остаткам на складах. |
| Метод | Что изменилось |
|---|---|
| /v5/product/info/prices | Добавили параметр items.price.auto_add_to_ozon_actions_list_enabled в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.auto_add_to_ozon_actions_list_enabled в запрос метода. Обновили описание параметра prices.auto_action_enabled в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/cluster/list | Удалили параметр clusters.logistic_clusters.is_archived из ответа метода. |
| Метод | Что изменилось |
|---|---|
| /v1/carriage/create /v1/carriage/approve /v1/carriage/delivery/list |
Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list /v3/posting/fbs/get |
Добавили параметр is_blr_traceable в ответы методов. |
| /v2/supply-order/get | Добавили параметры is_traceable и is_ettn_required в ответ метода. |
| /v1/supply-order/bundle | Добавили параметр item_tags_calculation в запрос метода и параметр tags в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/info/wrong-volume | Добавили бета-метод для получения списка товаров с некорректными объёмно-весовыми характеристиками. |
| Метод | Что изменилось |
|---|---|
| /v1/rating/summary | Добавили параметр premium_plus в ответ метода. |
| /v1/analytics/product-queries/details | Обновили описание параметров limit_by_sku, page и page_size в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/info | Обновили описание метода. Добавили возможное значение skipped параметра result.items.status в ответе метода. |
| /v1/description-category/attribute | Добавили параметр result.complex_is_collection в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/product-queries/details | Добавили метод для получения данных по запросам конкретного товара. |
| Метод | Что изменилось |
|---|---|
| /v1/actions/candidates /v1/actions/products |
Пометили параметр offset в запросе методов как устаревший и добавили параметр пагинации last_id. |
| Метод | Что изменилось |
|---|---|
| /v3/chat/history | Добавили новую версию метода для просмотра истории чата. |
| /v1/actions/hotsales/activate /v1/actions/hotsales/deactivate /v1/actions/hotsales/list /v1/actions/hotsales/products |
Методы устарели, удалили их из документации. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info | Метод устарел, удалили его из документации. Используйте /v3/product/info/list. |
| Метод | Что изменилось |
|---|---|
| /v2/report/returns/create | Добавили параметр result в ответ метода. Пометили обязательными параметры filter.date_from, filter.date_to и filter.status в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get | В ответе метода: • добавили параметр result.optional.products_with_possible_mandatory_mark,• пометили устаревшим параметр result.products.mandatory_mark. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
В ответе методов: • добавили параметр result.postings.optional.products_with_possible_mandatory_mark,• пометили устаревшим параметр result.postings.products.mandatory_mark. |
| /v3/posting/fbs/get /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Значения кодов маркировки можно получить через метод /v3/posting/fbs/get c with.product_exemplars: true в запросе или метод /v6/fbs/posting/product/exemplar/create-or-get. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/attributes | Добавили возможные значения параметра sort_by в запросе метода и добавили описания параметров result.barcodes и result.sku в ответ метода. |
| v2/supply-order/get | Пометили параметр creation_flow как устаревший. |
| Метод | Что изменилось |
|---|---|
| /v2/analytics/stock_on_warehouses | Обновили описание метода и отметили параметр result.rows.idc как устаревший, удалили его из примера. |
| /v1/warehouse/list /v1/actions |
Обновили описание метода. |
| /v3/posting/fbs/get | Добавили параметр result.previous_substatus в ответ метода. |
| /v3/finance/transaction/list | Обновили описание параметра result.operations.posting.delivery_schema в ответе метода. |
| /v1/analytics/product-queries | Добавили бета-метод для получения данных о запросах ваших товаров. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметра result.postings.analytics_data.city в ответе методов. |
| /v3/posting/fbs/get /v2/posting/fbo/list /v2/posting/fbo/get |
Обновили описание параметра result.analytics_data.city в ответе методов. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.net_price в запрос метода для указания себестоимости товара. |
| Метод | Что изменилось |
|---|---|
| /v5/product/info/prices | Перенесли метод из бета-раздела в основной. |
| /v4/product/info/prices | Метод устарел, удалили его из документации. |
| /v3/returns/company/fbo /v3/returns/company/fbs |
Методы устарели, удалили их из документации. Переключитесь на новую версию /v1/returns/list. |
| /v1/report/returns/create | Метод устарел, удалили его из документации. Переключитесь на новую версию /v2/report/returns/create. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info/list | Метод устарел, удалили его из документации. Переключитесь на новую версию /v3/product/info/list. |
| /v6/fbs/posting/product/exemplar/set /v6/fbs/posting/product/exemplar/create-or-get /v5/fbs/posting/product/exemplar/status /v5/fbs/posting/product/exemplar/validate /v1/fbs/posting/product/exemplar/update |
Добавили бета-методы для управления кодами маркировки. |
| Метод | Что изменилось |
|---|---|
| v2/supply-order/get | Добавили параметры orders.can_cancel, orders.is_econom, orders.is_virtual, orders.is_super_fbo, orders.product_super_fbo, orders.supplies.supply_state, orders.supplies.supply_tags.is_evsd_required, orders.supplies.supply_tags.is_jewelry, orders.supplies.supply_tags.is_marking_possible, orders.supplies.supply_tags.is_marking_required в ответ метода. |
| /v2/product/certification/list | Перенесли метод из бета-раздела в основной. |
| /v1/product/certification/list | Метод устаревает и будет отключён 14 апреля 2025 года. Переключитесь на новую версию /v2/product/certification/list. |
| Метод | Что изменилось |
|---|---|
| /v3/product/list | Перенесли метод из бета-раздела в основной. |
| /v2/product/list | Метод устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/stocks | Перенесли метод из бета-раздела в основной. |
| /v3/product/info/stocks | Метод устарел, удалили его из документации. |
| /v1/product/pictures/info | Метод устарел, удалили его из документации. Переключитесь на новую версию /v2/product/pictures/info. |
| /v3/product/info/attributes | Метод устарел, удалили его из документации. Переключитесь на новую версию /v4/product/info/attributes. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/awaiting-delivery | Обновили описание параметра posting_number в запросе метода. |
| /v4/product/info/attributes /v1/finance/document-b2b-sales /v1/finance/mutual-settlement |
Перенесли методы из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/cancel | Добавили бета-метод для отмены заявки на поставку. |
| /v1/supply-order/cancel/status | Добавили бета-метод для получения статуса отмены заявки на поставку. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/list | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/pick-up-code/verify | Добавили метод для проверки кода курьера. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.pickup_code_verified_at в ответы методов. |
| /v3/posting/fbs/get | Добавили параметр result.pickup_code_verified_at в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.min_price_for_auto_actions_enabled в запрос метода. |
| /v1/product/action/timer/update | Добавили бета-метод для обновления таймера актуальности минимальной цены. |
| /v1/product/action/timer/status | Добавили бета-метод для получения статуса установленного таймера. |
| Метод | Что изменилось |
|---|---|
| /v1/returns/list | Обновили описание параметров filter и filter.posting_numbers в запросе метода. |
| /v2/product/pictures/info | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/digital/act/document-sign | Метод устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/bundle | Добавили описание метода, изменили описания параметров bundle_ids, last_id и limit в запросе метода. |
| /v1/warehouse/fbo/list | Изменили название и описание метода, изменили описание параметра search в запросе метода. |
| /v1/draft/create/info | Обновили описание параметров clusters.warehouses.bundle_ids.bundle_id и clusters.warehouses.restricted_bundle_id в ответе метода. |
| /v1/cluster/list | Обновили описание параметра cluster_type в запросе метода. |
| /v1/warehouse/fbo/list | Обновили описание параметра filter_by_supply_type в запросе метода. |
| /v1/question/answer/create /v1/question/answer/delete /v1/question/answer/list /v1/question/change-status /v1/question/count /v1/question/info /v1/question/list /v1/question/top-sku |
Добавили бета-методы для работы с вопросами и ответами. |
| Метод | Что изменилось |
|---|---|
| /v1/review/comment/create /v1/review/comment/delete /v1/review/comment/list /v1/review/change-status /v1/review/count /v1/review/info /v1/review/list |
Добавили бета-методы для работы с отзывами. |
| /v1/carriage/create | Добавили бета-метод для создания отгрузки. |
| /v1/carriage/approve | Добавили бета-метод для подтверждения отгрузки. |
| /v1/carriage/delivery/list | Добавили бета-метод для получения списка методов доставки и отгрузок. |
| /v1/carriage/get | Добавили параметры result.is_waybill_enabled и result.is_econom в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/delivery-method/list | Добавили параметр result.sla_cut_in в ответ метода. |
| /v1/supply-order/get | Метод устарел, удалили его из документации. Используйте /v2/supply-order/get. |
| /v1/supply-order/list | Метод устарел, удалили его из документации. Используйте /v2/supply-order/list. |
| /v1/supply-order/items | Метод устарел, удалили его из документации. Используйте /v1/supply-order/bundle. |
| /v4/product/info/prices | Метод устаревает и будет отключён 17 февраля 2025 года. Переключитесь на новую версию /v5/product/info/prices. |
| /v3/product/info/list | Добавили параметр items.is_super в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.vat в запрос метода. |
| /v1/product/import-by-sku /v3/product/import |
Обновили описание параметра items.vat в запросе методов. |
| Метод | Что изменилось |
|---|---|
| /v2/report/returns/create /v1/posting/unpaid-legal/product/list |
Перенесли методы из бета-раздела в основной. |
| /v1/report/returns/create | Метод устаревает и будет отключён 15 февраля 2025 года. Переключитесь на новую версию /v2/report/returns/create. |
| /v3/returns/company/fbo /v3/returns/company/fbs |
Обновили дату отключения методов. |
| Метод | Что изменилось |
|---|---|
| /v1/carriage/set-postings | Добавили бета-метод для изменения состава отгрузки. |
| /v1/carriage/cancel | Добавили бета-метод для удаления отгрузки. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/list | Добавили бета-метод для получения списка товаров по идентификаторам. |
| /v2/product/info /v2/product/info/list |
Методы устаревают и будут отключены 17 февраля 2025 года. Переключитесь на новую версию /v3/product/info/list. |
| /v2/posting/fbs/act/list | Пометили обязательными параметры filter.date_from и filter.date_to в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/cargoes/create /v1/cargoes/create/info /v1/cargoes-label/create /v1/cargoes-label/get /v1/cargoes-label/file/{file_guid} |
Добавили бета-методы для работы с грузоместами. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема FBO добавили информацию об управлении грузоместами в заявке на поставку. |
| Метод | Что изменилось |
|---|---|
| /v2/product/pictures/info | Добавили бета-метод для получения изображений товаров. |
| /v1/product/pictures/info | Метод устаревает и будет отключён 11 февраля 2025 года. Переключитесь на новую версию /v2/product/pictures/info. |
| Метод | Что изменилось |
|---|---|
| /v1/returns/company/fbs/info | В ответе метода: • Добавили параметры drop_off_points.box_count и drop_off_points.utc_offset. • Удалили параметр company_id. |
| /v2/product/list | Удалили статус BANNED из запроса метода, при его использовании будет применено поле по умолчанию. Метод устаревает и будет отключён 9 февраля 2025 года. Переключитесь на новую версию /v3/product/list. |
| /v3/finance/transaction/list | Дополнили описание метода: используйте метод с последовательной отправкой запросов. Обновили описание параметров result.page_count и result.row_count в ответе метода. |
| /v3/product/info/attributes | Метод устаревает и будет отключён 9 февраля 2025 года. Переключитесь на новую версию /v4/product/info/attributes. |
| /v1/returns/list | Добавили параметр returns.product.quantity в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v2/product/certification/list | Добавили бета-метод для получения списка сертифицируемых категорий. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/stocks | Добавили бета-метод для получения информации о количестве товара. |
| /v3/product/info/stocks | Метод устаревает и будет отключён 31 января 2025 года. Переключитесь на новую версию /v4/product/info/stocks. |
| Метод | Что изменилось |
|---|---|
| /v2/finance/realization | Добавили параметры result.rows.return_commission.bank_coinvestment, result.rows.delivery_commission.pick_up_point_coinvestment и result.rows.return_commission.pick_up_point_coinvestment в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметров result.postings.analytics_data.city и result.postings.analytics_data.region в ответе методов. |
| /v3/posting/fbs/get | Обновили описание параметров result.analytics_data.city и result.analytics_data.region в ответе метода. |
| /v2/posting/fbo/list /v2/posting/fbo/get |
Параметры result.analytics_data.city и result.analytics_data.region в ответе методов устаревают и будут всегда возвращать пустое значение. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/turnover/stocks | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v2/report/returns/create | Добавили бета-метод для получения отчёта о возвратах FBO и FBS. |
| /v1/report/info | Добавили статус SELLER_RETURNS_V2 в параметр report_type. |
| /v1/posting/fbs/split | Перенесли метод из бета-раздела в основной. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/unpaid-legal/product/list | Добавили бета-метод для получения списка неоплаченных товаров, заказанных юридическими лицами. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import-by-sku | Обновили название и описание метода, обновили описание параметра items в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/manage/stocks | Добавили бета-метод для управления остатками на складах. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Обновили описание метода и описание параметра prices в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list /v3/posting/fbs/get |
Добавили параметр result.postings.tariffication в ответы методов. |
| /v1/posting/carriage-available/list | Добавили параметры result.recommended_time_local и result.recommended_time_utc_offset_in_minutes в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/report/list | Добавили статусы DOCUMENT_B2B_SALES и MUTUAL_SETTLEMENT в параметр запроса report_type. |
| /v1/report/info | Добавили статусы DOCUMENT_B2B_SALES и MUTUAL_SETTLEMENT в параметр ответа result.reports.report_type. |
| /v3/product/import /v2/products/stocks /v2/posting/fbs/product/cancel |
Обновили описания методов. |
| /v1/finance/cash-flow-statement/list | В описании параметра result.details.services.items.name изменили название операции MarketplaceServiceItemPremiumSubscribtion на MarketplaceServiceItemSubscribtionPremium. |
| — | В разделе Порядок работы с методами добавили информацию об ограничении отправки запросов. |
| Метод | Что изменилось |
|---|---|
| /v1/cluster/list | Добавили бета-метод для получения информации о кластерах. |
| /v1/draft/create | Добавили бета-метод для создания черновика заявки на поставку. |
| /v1/draft/create/info | Добавили бета-метод для получения информации о черновике заявки на поставку. |
| /v1/draft/timeslot/info | Добавили бета-метод для получения доступных таймслотов для черновика заявки на поставку. |
| /v1/draft/supply/create | Добавили бета-метод для создания заявки на поставку по черновику. |
| /v1/supply/create/status | Добавили бета-метод для получения информации о создании заявки на поставку. |
| /v1/warehouse/fbo/list | Добавили бета-метод для получения информации о складах для отгрузки. |
| /v1/finance/mutual-settlement | Добавили бета-метод для получения отчёта о взаиморасчётах. |
| /v1/finance/document-b2b-sales | Добавили бета-метод для получения отчёта о продажах юридическим лицам. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема FBO → Создать заявку на поставку добавили информацию о создании заявки на поставку по схеме FBO. |
| /v1/quant/list | Добавили бета-метод для получения списка квантов. |
| /v1/quant/get | Добавили бета-метод для получения информации о кванте и его отправлениях. |
| /v1/quant/ship | Добавили бета-метод для сборки отправлений кванта. |
| /v1/quant/status | Добавили бета-метод для получения статуса кванта. |
| /v1/product/quant/info | Добавили бета-метод для получения информации об эконом-товаре. |
| /v1/product/quant/list | Добавили бета-метод для получения списка эконом-товаров. |
| /v1/warehouse/list | Добавили параметр result.is_economy в ответ метода. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Добавили параметры filter.is_quantum в запрос и result.postings.quantum_id в ответ методов. |
| /v2/product/list | Добавили описание метода. У параметра filter.visibility в запросе метода удалили возможные значения IMAGE_ABSENT и MODERATION_BLOCK. |
| — | В разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS → Схема FBS Стандарт → Работа с эконом-товарами добавили информацию о работе с эконом-товарами. |
| /v2/products/stocks | Добавили параметр stocks.quant_size в запрос и result.quant_size в ответ метода. |
| /v1/product/import/prices | Добавили параметр prices.quant_size в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo /v3/returns/company/fbs |
Методы устаревают и будут отключены 28 декабря 2024 года. Переключитесь на метод /v1/returns/list. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/info | Параметр result.items.errors.optional_description_elements в ответе метода устаревает и будет всегда возвращать пустое значение. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/split | Добавили бета-метод для разделения заказа на отправления без сборки. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Добавили статусы arrived_for_resale и moving_to_resale в параметр запроса filter.status. |
| Метод | Что изменилось |
|---|---|
| — | Добавили раздел с методами, которые находятся на стадии тестирования. |
| /v1/analytics/turnover/stocks | Добавили бета-метод для получения информации об оборачиваемости товара. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/cutoff/set | Добавили метод для уточнения даты отгрузки отправления, которое доставляет неинтегрированный перевозчик или продавец. |
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Добавили параметр result.postings.available_actions в ответы методов. |
| /v3/posting/fbs/get | Добавили параметр result.available_actions в ответ метода. |
| — | Добавили информацию об указании даты отгрузки отправлений, которые доставляет неинтегрированный перевозчик или продавец по схемам rFBS Стандарт и rFBS Crossborder. |
| /v1/products/geo-restrictions-catalog-by-filter | Удалили метод /v1/products/geo-restrictions-catalog-by-filter из документации. |
| /v3/product/import | Обновили описание параметра items.geo_names в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/returns/list | Добавили метод для получения информации о возвратах FBO и FBS. |
| /v1/rating/summary | Добавили параметр localization_index в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import | Обновили раздел «Загрузка видео» в описании метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/list |
Обновили описание параметров result.postings.cancellation.cancellation_type и result.postings.cancellation.cancellation_initiator в ответе метода. |
| /v3/posting/fbs/get | Обновили описание параметров result.cancellation.cancellation_type и result.cancellation.cancellation_initiator в ответе метода. |
| /v1/finance/cash-flow-statement/list | Обновили описание параметра result.details.services.items.name в ответе метода. |
| /v3/finance/transaction/list | Обновили описание параметров filter.operation_type в запросе метода и result.operations.services.name в ответе метода. |
| /v4/posting/fbs/ship | Обновили описание метода. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbo/cancel-reason/list | Добавили метод для получения информации о причинах отмены отправлений по схеме FBO. |
| /v1/product/import/stocks /v2/products/stocks |
Обновили описание метода и параметра stocks.stock в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/product/cancel | Обновили описание метода. |
| /v2/posting/fbs/cancel-reason/list | Обновили пример ответа. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import /v3/products/info/attributes |
Параметр image_group_id устарел, удалили его из примеров кода. |
| Метод | Что изменилось |
|---|---|
| /v2/supply-order/get | Обновили описание параметра orders.state в ответе метода. |
| /v2/supply-order/list | Обновили описание параметра filter.states в запросе метода. |
| /v1/supply-order/bundle | Обновили описание параметров bundle_ids и limit в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/list /v1/supply-order/get |
Методы устаревают и будут отключены в будущем. Переключитесь на новые версии — /v2/supply-order/list и /v2/supply-order/get. |
| /v1/supply-order/status/counter | Добавили новый метод для получения статуса заявки и количества поставок в этом статусе. |
| /v1/supply-order/timeslot/get /v1/supply-order/timeslot/update /v1/supply-order/timeslot/status |
Добавили новые методы по работе с интервалами поставки. |
| /v1/supply-order/pass/create /v1/supply-order/pass/status |
Добавили новые методы для создания пропуска на фулфилмент и получения статуса данных. |
| /v1/supply-order/bundle | Добавили метод для получения состава поставки или заявки на поставку. |
| — | В разделе Порядок работы с методами → Схема FBO → Получите информацию о заявках на поставку обновили порядок работы с методами по схеме FBO. |
| Метод | Что изменилось |
|---|---|
| /v3/finance/transaction/list | Дополнили описание параметра filter.operation_type в запросе метода и result.operations.services.name в ответе метода. |
| /v2/finance/realization | Добавили параметр result.rows.delivery_commission.bank_coinvestment в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import /v3/products/info/attributes |
Добавили параметр items.type_id в запрос метода /v3/product/import и result.type_id в ответ метода /v3/products/info/attributes. Подробнее о переходе на type_id. |
| Метод | Что изменилось |
|---|---|
| /v2/analytics/stock_on_warehouses | Добавили параметр result.rows.idc в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import | Добавили параметр new_description_category_id в запрос метода — он используется для смены категории уже созданного товара. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute/values/search | Добавили метод для поиска по справочным значениям характеристики. |
| Метод | Что изменилось |
|---|---|
| Пуш-уведомления | Описали ошибки при подключении пуш-уведомлений. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/list | В запросе и ответе удалили статусы поставки по заявке: DRAFT, SUPPLY_VARIANTS_ARRANGING, HAS_NO_SUPPLY_VARIANTS_ARCHIVE, HAS_NO_SUPPLY_VARIANTS_NEW, SUPPLY_VARIANT_CONFIRMATION, TIMESLOT_BOOKING. |
| /v1/products/geo-restrictions-catalog-by-filter | Метод устаревает и будет отключён 1 октября 2024. |
| Метод | Что изменилось |
|---|---|
| Частые ошибки | Обновили описание ошибки Invalid Api-Key, please contact support для метода /v2/posting/fbs/act/create. |
| Частые ошибки | Удалили метод /v2/posting/fbs/ship из документации. |
| /v3/finance/transaction/list | Добавили вид услуги OperationMarketplaceAgencyFeeAggregator3PLGlobal в параметр result.operations.services.name. |
| /v1/report/info /v1/report/list /v1/report/products/create /v1/report/returns/create /v1/report/postings/create /v1/report/discounted/create /v1/report/warehouse/stock |
Обновили описание параметров code и file в ответах и запросах методов. |
| ## 22 июля 2024 |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list | Добавили параметр filter.last_changed_status_date в запрос метода. |
| Частые ошибки | Добавили описание ошибки GTD_MUST_BE_SPECIFIED_FOR_PRODUCT_COUNTRY для метода /v4/fbs/posting/product/exemplar/validate и NO_POSTINGS_FOR_BATCH_DOWNLOAD для метода /v2/posting/fbs/package-label. |
| /v2/product/info/list | В параметре product_id изменили описание формата ввода данных. |
| /v2/posting/fbo/list /v2/posting/fbo/get |
Добавили возможные значения параметра result.analytics_data.payment_type_group_name в ответе метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/get |
Добавили возможные значения параметра result.postings.analytics_data.payment_type_group_name в ответе метода. Дополнили описание статуса cancelled_from_split_pending. |
| /v3/posting/fbs/get | Обновили описание параметров addresse.phone, courier.phone и customer.phone в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/product/import /v1/product/import-by-sku /v2/product/info/list /v2/product/info /v4/product/info/prices |
Параметр premium_price устарел, удалили его из примеров кода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Удалили параметр customer.customer_email из ответа методов. |
| Раздел | Что изменилось |
|---|---|
| Порядок работы с методами | Добавили информацию о резервировании товаров. |
| Метод | Что изменилось |
|---|---|
| /v1/invoice/create-or-update | Метод устарел, удалили его из документации. Используйте /v2/invoice/create-or-update. |
| /v1/invoice/get | Метод устарел, удалили его из документации. Используйте /v2/invoice/get. |
| Метод / раздел | Что изменилось |
|---|---|
| /v3/finance/transaction/list | Заменили MarketplaceServiceStorageItem на OperationMarketplaceServiceStorage в параметре ответа operations.services. |
| /v1/product/related-sku/get | Обновили описание метода. |
| /v2/product/info/list | Обновили описание параметра items.id в ответе метода. |
| /v3/returns/company/fbs | Обновили описание параметра returns.moving_to_place_name в ответе метода. |
| /v2/posting/fbo/get /v2/posting/fbo/list /v3/posting/fbs/unfulfilled/list /v3/posting/fbs/get /v3/posting/fbs/list |
Пометили устаревшими параметры postings.financial_data.products.item_services и postings.financial_data.posting_services в ответе методов. |
| Частые ошибки | Добавили описание ошибки Incorrect_density для метода /v3/product/import и Incorrect_carriage_status для /v2/posting/fbs/act/create. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/package-label/create | Добавили новую версию метода для создания задания на формирование этикеток. |
| /v1/posting/fbs/package-label/create | Метод устаревает и будет отключён в будущем. Мы предупредим вас об этом за месяц. Переключитесь на новую версию /v2/posting/fbs/package-label/create. |
| Метод | Что изменилось |
|---|---|
| /v4/posting/fbs/ship | Добавили описание ошибки EXEMPLAR_INFO_NOT_FILLED_COMPLETELY в таблице Частые ошибки. |
| /v3/returns/company/fbs | Обновили описание параметра filter.status в запросе метода и параметра returns.product_id в ответе метода. |
| /v4/posting/fbs/ship/package /v1/product/import/prices |
Обновили описание метода. |
| /v3/product/import | Изменили описание параметра items.description_category_id в примере запроса. |
| /v4/product/info/prices /v3/product/import /v2/product/info/list /v2/product/info /v1/product/import-by-sku |
Отметили устаревшим параметр premium_price в ответах и запросах методов. |
| /v1/description-category/attribute/values /v1/description-category/attribute /v1/description-category/tree |
Добавили примеры запросов и ответов. |
| — | Обновили описание уведомлений TYPE_NEW_POSTING, TYPE_POSTING_CANCELLED, TYPE_STATE_CHANGED, TYPE_CUTOFF_DATE_CHANGED, TYPE_DELIVERY_DATE_CHANGED в разделе Пуш-уведомления. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info | Добавили параметры result.is_archived и result.is_autoarchived в ответ метода. |
| /v2/product/info/list | Добавили параметры result.items.is_archived и result.items.is_autoarchived в ответ метода. |
| /v1/product/unarchive | Метод доступен для работы. Обновили описание параметра product_id в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/stocks | Обновили описание метода. Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| — | В разделе Частые ошибки для методов /v2/products/stocks и /v1/product/import/stocks добавили описание ошибок Fatal error: You have more than 1 FBS warehouses. Please use API Method POST /v2/products/stocks, product_is_not_created, offer_id_not_found, FLAMMABLE_ONLY_ON_SELF_OR_PROVIDER_DELIVERY и WAREHOUSE_NOT_FOUND. |
| /v1/product/import/stocks /v2/products/stocks |
Обновили описание параметра result.errors.code в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/finance/realization | Добавили новую версию метода для получения отчёта о реализации товаров. |
| /v1/invoice/create-or-update | Метод устаревает и будет отключён 31 мая 2024 года. Переключитесь на новую версию /v2/invoice/create-or-update. |
| /v1/invoice/file/upload | Добавили метод для загрузки счёта-фактуры. |
| /v1/invoice/get | Метод устаревает и будет отключён 31 мая 2024 года. Переключитесь на новую версию /v2/invoice/get. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Частые ошибки для методов /v4/fbs/posting/product/exemplar/set и /v5/fbs/posting/product/exemplar/set добавили описание ошибок GTD_IS_REQUIRED_ONLY_FOR_LEGAL_CUSTOMER и EXEMPLAR_ID does not belong to product PRODUCT_ID. |
| Метод | Что изменилось |
|---|---|
| /v3/finance/transaction/list | В ответе метода дополнили описание параметра result.operations.services.name. |
| /v1/pricing-strategy/product/info | Добавили описание метода. |
| /v3/product/import | Дополнили описание метода информацией о загрузке видеообложек. |
| — | В разделе Частые ошибки для метода /v2/products/stocks: • удалили описание ошибки SKU STOCK NOT CHANGED;• добавили описание ошибки NOT_FOUND_ERROR. |
| — | Дополнили раздел Порядок работы с методами → Схема FBS Стандарт информацией о получении exemplar_id методом /v5/fbs/posting/product/exemplar/create-or-get. |
| Метод / раздел | Что изменилось |
|---|---|
| /v1/carriage/get | Обновили описание параметра status в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/pictures/import /v1/product/pictures/info |
В ответе метода для поля result.pictures.state изменили статус failed на pending. |
| Метод / раздел | Что изменилось |
|---|---|
| /v1/carriage/get | Добавили метод для получения информации о перевозке. |
| /v1/carriage/pass/create | Добавили метод для создания пропуска. |
| /v1/carriage/pass/update | Добавили метод для обновления пропуска. |
| /v1/carriage/pass/delete | Добавили метод для удаления пропуска. |
| /v1/return/pass/create | Добавили метод для создания пропуска на вывоз возвратов. |
| /v1/return/pass/update | Добавили метод для обновления пропуска на вывоз возвратов. |
| /v1/return/pass/delete | Добавили метод для удаления пропуска на вывоз возвратов. |
| /v1/pass/list | Добавили метод для получения списка пропусков. |
| /v1/returns/company/fbs/info | Добавили метод для получения информации о возвратах FBS и их количестве. |
| Порядок работы с методами | В разделах Схема FBS Стандарт и Получите возвратные отгрузки по штрихкоду описали новые методы по работе с пропусками. |
| Доставка FBS | Создали новый раздел, перенесли в него старые методы и добавили новый — /v1/carriage/get. |
| Доставка rFBS | Создали новый раздел, перенесли в него старые методы. |
| Метод | Что изменилось |
|---|---|
| /v2/product/info | Параметр minValue в ответе метода устарел, удалили его из документации. |
| /v4/product/info/prices /v2/product/info |
Параметр recommended_price в ответе метода устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list /v3/posting/fbs/get /v3/posting/fbs/unfulfilled/list /v2/posting/fbo/get /v2/posting/fbo/list |
Отметили устаревшим параметр client_price в ответе. |
| Метод | Что изменилось |
|---|---|
| /v2/category/attribute/values | Метод устарел, удалили его из документации. Используйте /v1/description-category/attribute/values. |
| /v2/category/tree | Метод устарел, удалили его из документации. Используйте /v1/description-category/tree. |
| /v3/category/attribute | Метод устарел, удалили его из документации. Используйте /v1/description-category/attribute. |
| /v2/product/import | Метод устарел, удалили его из документации. Используйте /v3/product/import. |
| /v3/posting/fbs/unfulfilled/list | Добавили значение hybryd для параметра ответа tpl_integration_type. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Удалили параметр accepted_from_customer_moment из запроса и ответа метода. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Порядок работы с методами добавили, что для продавцов rFBS Стандарт с 11 марта 2024 года максимальный срок доставки до покупателя — 30 дней. Обновите срок в настройках вашего метода. Если срок будет больше максимального, он поменяется автоматически. |
| Метод | Что изменилось |
|---|---|
| /v2/category/tree /v3/category/attribute /v2/category/attribute/values /v2/product/import |
Методы устаревают и будут отключены 11 марта 2024 года. |
| Метод | Что изменилось |
|---|---|
| /v1/chat/list | Метод устарел, удалили его из документации. Используйте /v2/chat/list. |
| /v1/chat/history /v1/chat/updates |
Методы устарели, удалили их из документации. Используйте /v2/chat/history. |
| Метод | Что изменилось |
|---|---|
| /v4/posting/fbs/ship/package | Дополнили описание метода: по умолчанию статус созданных отправлений awaiting_deliver. |
| /v2/chat/history | Добавили описание метода. |
| /v1/analytics/data | Обновили описание параметра id в ответе метода. |
| /v5/fbs/posting/product/exemplar/create-or-get | Дополнили описание метода: используйте метод для получения exemplar_id. |
| /v5/fbs/posting/product/exemplar/set | Дополнили описание метода информацией об ответе. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute | Добавили параметр result.category_dependent в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/ship | Метод устарел, удалили его из документации. Используйте /v4/posting/fbs/ship. |
| /v3/posting/fbs/ship/package | Метод устарел, удалили его из документации. Используйте /v4/posting/fbs/ship/package. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo | Добавили параметр return_id и обновили описание параметра id в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo | Обновили описания параметров status в запросе метода и status_name в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/attribute | Добавили два параметра в ответ метода: max_value_count и attribute_complex_id. |
| /v3/product/import | Добавили новую версию метода для загрузки и обновления товаров. |
| /v2/product/info /v2/product/info/list |
Добавили параметр type_id в ответ методов. |
| /v1/description-category/tree /v1/description-category/attribute /v1/description-category/attribute/values |
Изменили параметр category_id на description_category_id в запрос и ответ методов. |
| Метод | Что изменилось |
|---|---|
| /v1/chat/list | Дополнили значение параметра page_size в запросе метода. Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| /v1/chat/history | Обновили значения параметра limit в запросе метода. Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| /v2/chat/list /v2/chat/history |
Дополнили значения параметра limit в запросах методов. |
| /v1/chat/updates | Дополнили значения параметра limit в запросах методов. Метод устаревает и будет отключён в будущем. Переключитесь на альтернативную версию — указали её в описании метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbo/list | Дополнили описание метода: если период больше года, вернётся ошибка PERIOD_IS_TOO_LONG. Обновили описание параметра offset в запросе метода. |
| /v3/products/info/attributes | Добавили описание параметра images.default в ответе метода. |
| /v3/posting/fbs/unfulfilled/list | Из описания метода убрали статус delivered и добавили информацию о получении актуальной даты отгрузки. |
| /v1/finance/cash-flow-statement/list | Дополнили значения параметра items.name в ответе метода. |
| /v2/product/info/list | Из описания метода убрали информацию о совпадении полей в параметре items с методом /v2/product/info. |
| /v3/posting/fbs/list /v3/posting/fbs/get |
Обновили описание метода: добавили информацию о получении актуальной даты отгрузки. |
| /v2/posting/fbs/cancel | Обновили описание метода: убрали идентификаторы причин отмены и добавили информацию о проверке статуса отмены для отправления. |
| /v3/finance/transaction/list | Дополнили значения параметра filter.operation_type в запросе метода. |
| /v1/product/import/prices | Обновили описание метода: добавили информацию об ошибке action_price_enabled_min_price_missing. |
| /v3/finance/transaction/totals | Дополнили описание метода: если номера отправлений заполнены неправильно, в ответе вернутся нулевые значения. |
| /v1/product/import/stocks | Обновили описание метода: задать наличие товара возможно только после того, как его статус сменится на price_sent. |
| /v1/report/info | Обновили описание параметра result.file в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/package-label | Обновили описание метода: убрали информацию, что при работе по схеме rFBS не нужно печатать этикетки. |
| Метод | Что изменилось |
|---|---|
| /v5/fbs/posting/product/exemplar/set | Добавили новую версию метода для проверки и сохранения данных экземпляров. |
| /v5/fbs/posting/product/exemplar/create-or-get | Добавили метод для получения данных о созданных экземплярах. |
| /v4/posting/fbs/ship/package | Добавили новую версию метода для частичной сборки отправления. |
| /v4/fbs/posting/product/exemplar/status /v3/posting/fbs/get |
Добавили параметр exemplars.exemplar_id в ответы методов. |
| Метод | Что изменилось |
|---|---|
| /v2/returns/rfbs/list | Добавили метод для получения заявок на возврат rFBS-заказов. |
| /v2/returns/rfbs/get | Добавили метод для получения информации о заявке на возврат rFBS-заказа. |
| /v2/returns/rfbs/reject | Добавили метод для отклонения заявки на возврат rFBS-заказа. |
| /v2/returns/rfbs/compensate | Добавили метод для частичной компенсации стоимости товара в rFBS-заказе. |
| /v2/returns/rfbs/verify | Добавили метод для одобрения заявки на возврат rFBS-заказа. |
| /v2/returns/rfbs/receive-return | Добавили метод для подтверждения, что товар получили для проверки. |
| /v2/returns/rfbs/return-money | Добавили метод для возврата полной стоимости товара в rFBS-заказе. |
| — | В раздел Порядок работы с методами добавили подраздел Управляйте заявками на возврат rFBS-заказов. |
| Метод | Что изменилось |
|---|---|
| /v1/return/giveout/is-enabled | Добавили метод для проверки возможности получения возвратных отгрузок по штрихкоду. |
| /v1/return/giveout/get-pdf /v1/return/giveout/get-png |
Добавили методы для получения штрихкода возвратной отгрузки в формате PDF и PNG. |
| /v1/return/giveout/barcode | Добавили метод для получения штрихкода возвратной отгрузки в текстовом виде. |
| /v1/return/giveout/barcode-reset | Добавили метод для обновления штрихкода возвратной отгрузки. |
| /v1/return/giveout/list | Добавили метод для получения списка возвратных отгрузок. |
| /v1/return/giveout/info | Добавили метод для получения информации о возвратных отгрузках. |
| Метод | Что изменилось |
|---|---|
| v3/posting/fbs/list | Обновили пример запроса. |
| /v3/finance/transaction/list | Дополнили описание параметра result.operations.services.name в ответе метода: добавили услугу drop-off в пункте приёма заказов. |
| /v2/product/info /v2/product/info/list |
Дополнили описание метода: параметр active_product устарел, используйте значение параметра visible. |
| /v1/report/warehouse/stock | Обновили описание метода: он возвращает остатки только для FBS-складов. |
| /v2/products/stocks | Обновили описание метода: задать наличие товара возможно только после того, как его статус сменится на price_sent. |
| Метод | Что изменилось |
|---|---|
| /v1/report/postings/create | Обновили описание параметра delivery_schema в запросе метода и пример запроса. |
| Метод | Что изменилось |
|---|---|
| /v1/product/related-sku/get | Добавили метод для получения связанных SKU. |
| Метод | Что изменилось |
|---|---|
| /v3/product/info/stocks | Обновили пример ответа. Теперь метод возвращает остатки товаров по всем схемам работы — FBO, FBS и Crossborder, даже если вы не работаете по каким-то из них. |
| /v1/report/info | Добавили описания статусов waiting и processing в параметр status их ответа метода. |
| /v3/posting/fbs/ship | Метод устаревает и будет отключён в будущем. Переключитесь на новую версию — указали её в описании метода. |
| Метод | Что изменилось |
|---|---|
| /v1/report/warehouse/stock | Добавили метод для формирования отчёта об остатках на складе. |
| /v1/report/list | Добавили в ответ метода, в течение какого времени доступна ссылка для получения отчёта с report_type="SELLER_RETURNS". |
| /v1/report/returns/create | В ответ метода добавили, в течение какого срока можно получить отчёт по идентификатору. |
| /v1/report/stock/create | Метод устарел, удалили его из документации. Используйте /v1/report/warehouse/stock. |
| /v1/report/discounted/info | Метод устарел, удалили его из документации. Чтобы получить отчёт об уценённых товарах, запустите формирование через /v1/report/discounted/create и получите его через /v1/report/info. |
| /v1/report/discounted/list | Метод устарел, удалили его из документации. Чтобы получить список отчётов об уценённых товарах, сделайте запрос метода /v1/report/info с report_type="SELLER_PRODUCT_DISCOUNTED". |
| /v1/report/products/movement/create | Метод устарел, удалили его из документации. |
| Метод | Что изменилось |
|---|---|
| — | В раздел Порядок работы с методами добавили подраздел Схема rFBS Express с доставкой в пункт выдачи. |
| Метод | Что изменилось |
|---|---|
| — | Дополнили таблицу Частые ошибки. Добавили описания ошибок в методах: • /v2/products/stocks • /v3/posting/fbs/ship • /v4/posting/fbs/ship • /v2/posting/fbs/package-label • /v2/posting/fbs/act/create • /v2/posting/fbs/cancel • /v2/product/import |
| /v1/posting/carriage-available/list /v2/posting/fbs/act/create /v2/posting/fbs/act/check-status /v2/posting/fbs/act/get-pdf |
Для продавцов из СНГ остаются бумажные акты приёма-передачи при работе по схеме FBS. Дополнили описания методов — указали, какие документы можно получить продавцам из России и СНГ. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/carriage-available/list /v2/posting/fbs/act/create /v2/posting/fbs/act/check-status /v2/posting/fbs/act/get-pdf /v2/posting/fbs/digital/act/check-status /v2/posting/fbs/digital/act/get-pdf |
Отказались от актов приёма-передачи при работе по схеме FBS — теперь вместо них можно получить лист отгрузки. Обновили описания методов, в которых затрагивались акты, и порядок работы с ними: • Схема FBS Стандарт: изменили пункты 6–11. • Схема FBS PickUp с доверительной приёмкой: изменили пункты 6–8. Подробнее об изменениях на dev.ozon.ru |
| Метод | Что изменилось |
|---|---|
| /v1/description-category/tree | Добавили новую версию метода для получения дерева категорий и типов товаров. |
| /v1/description-category/attribute | Добавили новую версию метода для получения характеристик категории и типа товара. |
| /v1/description-category/attribute/values | Добавили новую версию метода для получения значений характеристики. |
| /v2/category/tree /v3/category/attribute /v2/category/attribute/values |
Методы устаревают и будут отключены в будущем. Переключитесь на новые версии — указали их в описании методов. |
| /v3/products/info/attributes /v2/product/info /v2/product/info/list |
Добавили параметр description_category_id в ответах методов и указали, как его использовать. Пометили параметр category_id в ответах методов как устаревающий и указали, как его использовать. |
| — | В разделе Порядок работы с методами → Выгрузите атрибуты и характеристики Ozon обновили версии методов. |
| Метод | Что изменилось |
|---|---|
| /v1/barcode/add | Добавили метод для привязки штрихкодов к товарам. |
| /v1/barcode/generate | Добавили метод для создания штрихкодов на товары. |
| Метод | Что изменилось |
|---|---|
| /v2/products/stocks | Добавили описание ошибки MP_DELIVERY_ONLY_3PL_ERROR:• в описание параметра result.errors в ответе метода,• в раздел «Частые ошибки». |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/prices | Добавили информацию о работе параметров fbo_direct_flow_trans_max_amount и fbo_direct_flow_trans_min_amount в описание метода. |
| /v2/product/info | Добавили информацию о работе параметра min_price в описание метода. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/data | Добавили ограничения для продавцов без Premium-подписки: • в описание метода, • в описание параметров date_from, dimension и metrics в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Обновили описание параметра price в запросе метода. Указали, какой должна быть разница между price и old_price. |
| Метод | Что изменилось |
|---|---|
| /v1/report/transactions/create | Метод устарел, удалили его из документации. Используйте /v3/finance/transaction/list. |
| /v2/product/info/limit /v3/product/info/limit |
Методы устарели, удалили их документации. Используйте /v4/product/info/limit. |
| /v1/report/products/prices/create | Метод устарел, удалили его из документации. Используйте /v4/product/info/price. |
| /v1/analytics/item_turnover | Метод устарел, удалили его из документации. Чтобы получить отчёт по оборачиваемости FBO, запросите его в личном кабинете. |
| /v1/analytics/stock_on_warehouses | Метод устарел, удалили его из документации. Используйте /v2/analytics/stock_on_warehouses. |
| /v2/returns/company/fbs | Метод устарел, удалили его из документации. Используйте /v3/returns/company/fbs. |
| /v1/report/finance/create | Метод устарел, удалили его из документации. Используйте /v1/finance/cash-flow-statement/list. |
| /v2/returns/company/fbo | Метод устарел, удалили его из документации. Используйте /v3/returns/company/fbo. |
| Метод | Что изменилось |
|---|---|
| /v1/analytics/data | Удалили метрики из параметра metrics в запросе метода: • adv_view_pdp, • adv_view_search_category, • adv_view_all, • adv_sum_all, • postings, • postings_premium. |
| /v1/invoice/create-or-update | Добавили параметры HS_code, date, number, price и price_currency в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v1/product/info/stocks-by-warehouse/fbs | Добавили параметры sku в запрос метода и result.sku в ответ метода.Добавили дату отключения параметров fbs_sku в запрос метода и result.fbs_sku в ответ метода. |
| /v2/product/info | Добавили параметр result.sku в ответ метода.Добавили дату отключения параметров result.fbs_sku и result.fbo_sku в ответ метода. |
| /v2/product/info/list | Добавили параметр result.items.sku в ответ метода.Добавили дату отключения параметров result.items.fbs_sku и result.items.fbo_sku в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/prices | Добавили в ответ метода параметры: • result.items.acquiring,• result.items.comissions.sales_percent_fbo,• result.items.comissions.sales_percent_fbs.Дополнили в ответе методов описания параметров: • result.items.comissions.fbs_first_mile_min_amount,• result.items.comissions.fbs_first_mile_max_amount,• result.items.comissions.sales_percent. |
| Метод | Что изменилось |
|---|---|
| /v1/product/import/prices | Добавили параметр prices.price_strategy_enabled в запрос метода. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/act/get-barcode /v2/posting/fbs/act/get-pdf /v2/posting/fbs/digital/act/get-pdf /v2/posting/fbs/package-label /v2/posting/fbs/act/get-container-labels |
Обновили схемы и примеры для ответов методов: методы возвращают результат в бинарном виде. |
| /v1/posting/fbs/package-label/create | Обновили пример ответа. |
| /v1/posting/fbs/package-label/get | Добавили пример ответа. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/act/get-barcode | Удалили параметр doc_type из запроса метода. |
| /v2/posting/fbs/act/get-barcode/text | Добавили метод, в котором можно получить значение штрихода из ответа /v2/posting/fbs/act/get-barcode. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbo | Добавили описание параметра filter.status в запросе метода.Дополнили описание параметра returns.status_name в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Добавили параметры returns.exemplar_id и returns.return_barcode в ответ метода.Изменили описания параметров returns.id, returns.return_clearing_id и clearing_id в ответе метода. |
| Метод | Что изменилось |
|---|---|
| — | Дополнили описание для всех схем FBS и rFBS в разделе Порядок работы с методами → Управляйте заказами FBO, FBS и rFBS. Добавили изначальные статусы отправлений, а также ограничение для сборки заказа. |
| Метод | Что изменилось |
|---|---|
| — | Добавили описание уведомления TYPE_CREATE_OR_UPDATE_ITEM в раздел Пуш-уведомления → Уведомления, которые отправляет Ozon. |
| — | 15 июля 2023 года пуш-уведомления TYPE_CREATE_ITEM и TYPE_UPDATE_ITEM будут отключены. Добавили предупреждение в описания уведомлений. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр result.postings.prr_option в ответы методов. |
| /v3/posting/fbs/get | Добавили параметры result.prr_option.code, result.prr_option.price, result.prr_option.currency_code, result.prr_option.floor в ответ метода. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/timeslot/set | Обновили пример запроса. |
| /v2/posting/fbo/list | Исправили формат даты в примере ответа. |
| /v2/posting/fbs/cancel /v2/posting/fbs/product/cancel |
Дополнили описания методов. |
| /v2/posting/fbs/act/list | Добавили значение статуса closed в описание параметра filter.status в запросе метода. |
| /v1/product/unarchive | С 14 июня 2023 метод не работает. Добавили предупреждение в описание метода и раздел Отключение методов. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/fbs/get | Добавили параметры jw_uin и products_requiring_jw_uin в ответ метода. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
Добавили параметр products_requiring_jw_uin в ответы методов. |
| /v4/fbs/posting/product/exemplar/set | Добавили параметр jw_uin в запрос метода. |
| /v4/fbs/posting/product/exemplar/status | Добавили параметры jw_uin, jw_uin_check_status и jw_uin_error_codes в ответ метода. |
| /v4/fbs/posting/product/exemplar/validate | Добавили параметр jw_uin в запрос и ответ метода. |
| /v1/product/archive /v1/product/unarchive |
Добавили ограничение на количество product_id, которые можно передать в одном запросе. |
| Метод | Что изменилось |
|---|---|
| /v2/posting/fbs/act/get-barcode | Добавили метод получения штрихкода для отгрузки товара. |
| Метод | Что изменилось |
|---|---|
| /v2/fbs/posting/tracking-number/set | Добавили ограничение на добавление трек-номеров в описание метода. |
| /v1/supplier/available_warehouses | Добавили метод для проверки загруженности складов Ozon. |
| Метод | Что изменилось |
|---|---|
| /v1/product/attributes/update | Добавили метод для обновления характеристик товара. |
| Метод | Что изменилось |
|---|---|
| — | Обновили инструкцию Как получить API-ключ. |
| Метод | Что изменилось |
|---|---|
| /v1/finance/cash-flow-statement/list | Добавили необязательный параметр with_details в запрос метода и параметр details в ответ метода. |
| /v1/pricing-strategy/competitors/list | Добавили метод для получения списка конкурентов. |
| /v1/pricing-strategy/list | Добавили метод для получения списка стратегий ценообразования. |
| /v1/pricing-strategy/create | Добавили метод для создания стратегии ценообразования. |
| /v1/pricing-strategy/info | Добавили метод для получения информации о стратегии ценообразования. |
| /v1/pricing-strategy/update | Добавили метод для изменения списка выбранных конкурентов и названия стратегии ценообразования. |
| /v1/pricing-strategy/products/add | Добавили метод для добавления товаров в стратегию ценообразования. |
| /v1/pricing-strategy/strategy-ids-by-product-ids | Добавили метод для проверки привязки товара к стратегии ценообразования. |
| /v1/pricing-strategy/products/list | Добавили метод для получения списка товаров, которые привязаны к стратегии ценообразования. |
| /v1/pricing-strategy/products/delete | Добавили метод для удаления товаров из стратегии ценообразования. |
| /v1/pricing-strategy/product/info | Добавили метод для получения цены товара у конкурента. |
| /v1/pricing-strategy/status | Добавили метод для включения и отключения стратегии ценообразования. |
| /v1/pricing-strategy/delete | Добавили метод для удаления стратегии ценообразования. |
| — | В разделе Порядок работы с методами добавили подраздел Настройте стратегии ценообразования. |
| Метод | Что изменилось |
|---|---|
| /v1/product/info/subscription | Добавили метод для получения количества пользователей, подписанных на товары. |
| /v2/product/info | Добавили параметр result.price_indexes в ответ метода.Пометили параметр result.price_index в ответе как неактуальный. |
| /v2/product/info/list /v4/product/info/prices |
Добавили параметр result.items.price_indexes в ответ метода.Пометили параметр result.items.price_index в ответе как неактуальный. |
| /v3/posting/fbs/get | Добавили параметр result.substatus в ответ метода. |
| /v3/posting/fbs/list | Добавили параметр result.postings.substatus в ответ метода.Дополнили описание параметра result.postings.status в ответе метода. |
| Метод | Что изменилось |
|---|---|
| /v1/supply-order/list | Добавили метод для получения списка заявок на поставку на склад Ozon. |
| /v1/supply-order/get | Добавили метод для получения информации о заявке на поставку. |
| /v1/supply-order/items | Добавили метод для получения списка товаров в заявке на поставку. |
| — | Добавили подраздел Схема FBO → Получите информацию о заявках на поставку в раздел Порядок работы с методами. |
| Метод | Что изменилось |
|---|---|
| /v3/returns/company/fbs | Добавили новую версию метода для получения информации о возвратах FBS. |
| Метод | Что изменилось |
|---|---|
| — | В раздел Пуш-уведомления → Как подключить добавили IP-адреса, с которых отправляются уведомления. |
| /v2/returns/company/fbs | Добавили описание статусов moving, disposed и disposing для параметра filter.status в запросе метода. |
| /v3/finance/transaction/list | Дополнили описание параметра filter.operation_type в запросе метода. |
| Метод | Что изменилось |
|---|---|
| /v3/finance/transaction/list | Обновили описание метода: теперь максимальный период, за который можно получить информацию в одном запросе — 1 месяц. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/fbs/timeslot/set | Добавили метод для переноса даты доставки отправления. |
| /v1/posting/fbs/timeslot/change-restrictions | Добавили метод для получения доступных дат для переноса доставки и количества доступных переносов. |
| Метод | Что изменилось |
|---|---|
| /v2/analytics/stock_on_warehouses | Добавили новую версию метода для получения отчёта по товарам и остаткам. |
| Метод | Что изменилось |
|---|---|
| /v1/posting/global/etgb | Добавили метод для получения таможенных деклараций ETGB. |
| Метод | Что изменилось |
|---|---|
| — | В разделе Пуш-уведомления → Как подключить обновили инструкцию: теперь подключать пуш-уведомления нужно в личном кабинете. В раздел Уведомления, которые отправляет Ozon добавили описания новых типов уведомлений: • TYPE_NEW_MESSAGE • TYPE_UPDATE_MESSAGE • TYPE_MESSAGE_READ • TYPE_CHAT_CLOSED |
| /v1/posting/fbs/package-label/create /v1/posting/fbs/package-label/get |
Добавили методы для асинхронного формирования этикеток. |
| Метод | Что изменилось |
|---|---|
| /v2/returns/company/fbo /v3/product/info/limit /v1/analytics/stock_on_warehouses /v1/analytics/item_turnover |
1 апреля 2023 отключим эти методы. Добавили предупреждение в описание методов и в раздел Отключение методов. |
| /v1/auto/bookings/get /v1/auto/bookings/list /v1/auto/cbos/list /v1/auto/modifications/list /v1/auto/offers/create /v1/auto/offers/list /v1/auto/offers/update |
Удалили раздел Автомобили из документации. |
| Метод | Что изменилось |
|---|---|
| /v4/product/info/limit | Добавили метод для получения лимитов на ассортимент, создание и обновление товаров. |
| Метод | Что изменилось |
|---|---|
| /v1/product/update/discount | Добавили метод для установки скидки на уценённые товары, продающиеся по схеме FBS. |
| /v2/posting/fbs/act/list | Обновили описание параметра filter.status в запросе. |
| /v3/category/attribute | Добавили поле result.attributes.category_dependent в ответ метода. |
| Метод | Что изменилось |
|---|---|
| — | Дополнили таблицу «Частые ошибки». Добавили описания ошибок для метода /v2/posting/fbs/act/create. |
| /v2/product/info /v1/product/info/list |
В ответы методов добавили поле updated_at: дата последнего обновления товара. |
| Метод | Что изменилось |
|---|---|
| /v2/product/import /v1/product/import-by-sku |
В запросах методов обновили описание параметра offer_id: максимальная длина передаваемого значения — 50 символов. |
| /v1/product/update/offer-id | В запросе метода обновили описание параметра new_offer_id: максимальная длина передаваемого значения — 50 символов. |
| Метод | Что изменилось |
|---|---|
| /v2/category/tree | В запросе метода обновили значение параметра language для китайского языка. |
| Метод | Что изменилось |
|---|---|
| /v3/posting/multiboxqty/set | Добавили метод для передачи количества коробок в многокоробочных отправлениях. |
| /v3/posting/fbs/get | В ответ метода добавили поля для получения информации о многокоробочных отправлениях: result.is_multibox и result.multi_box_qty. |
| /v3/posting/fbs/list /v3/posting/fbs/unfulfilled/list |
В ответы методов добавили поля для получения информации о многокоробочных отправлениях: result.postings.is_multibox и result.postings.multi_box_qty. |
| /v2/posting/fbs/act/get-postings | В ответ метода добавили поле result.multi_box_qty для получения количества коробок в многокоробочных отправлениях. |
| Метод | Что изменилось |
|---|---|
| — | Обновили срок подключения пуш-уведомлений. |
| /v1/supplier/orders/{orderId}/waybill_acceptance_results /v1/supplier/waybill_acceptance_results/{waybillId} |
Убрали методы из документации. |
| /v3/category/attribute | В ответ метода добавили поле result.attributes.is_aspect. |
| /v2/product/info /v2/product/info/list |
В ответы методов добавили поле barcodes для получения всех штрихкодов товара. |